Claude connector
Connect Claude to your social media
Add Onlypult as a custom connector in Claude.ai or Claude Desktop, sign in once, and Claude can draft, schedule, publish and analyze posts on 15+ networks — from any chat.
- Any Claude plan
- OAuth — no API key
- Drafts first
Turn this blog post into a LinkedIn post and an Instagram caption with the cover image. Save both as drafts.
Done — two drafts are waiting in your Onlypult calendar. Nothing has been published.
- DraftLinkedIn · Company page — 1,180 characters
- DraftInstagram — caption, 12 hashtags, cover image
How to connect Claude to Onlypult
Claude.ai and Claude Desktop use the same custom connector. You sign in with your Onlypult account — Claude never sees a password or a key.
https://mcp.onlypult.com/mcp - 1
In Claude, click your profile, open Settings and choose Connectors. Click Add custom connector.
- 2
Name it Onlypult and paste the server URL above. Leave OAuth Client ID and Secret empty — Onlypult discovers them automatically.
- 3
Click Connect, sign in to Onlypult and press Allow access. The connector status changes to connected.
- 4
Open a new chat. The first time Claude wants an Onlypult tool it asks for permission — choose Always allow for reads and drafts.
Claude's free plan allows one custom connector — remove another one first if it's taken. On Team and Enterprise plans an owner may need to allow custom connectors.
Want Claude to upload images straight from a folder on your Mac or PC? Run the local Onlypult package from Claude Desktop instead of the hosted connector. Requires Node.js 18+.
- 1
In Onlypult, open Settings → API Keys and create a key. It starts with
op_and is shown once — copy it somewhere safe. - 2
Open the config file:
~/Library/Application Support/Claude/claude_desktop_config.jsonon macOS or%APPDATA%\Claude\claude_desktop_config.jsonon Windows. - 3
Paste the block below, replace the key, save and fully restart Claude Desktop.
{
"mcpServers": {
"onlypult": {
"command": "npx",
"args": ["-y", "@onlypult/mcp@latest"],
"env": {
"ONLYPULT_API_KEY": "op_your_api_key"
}
}
}
} This config file only supports local servers. For the hosted server, use Settings → Connectors as in the first tab — don't add "type": "http" here.
Check it worked: in a new chat ask “Show my connected social profiles in Onlypult”. Claude should list your profiles with their networks.
Claude prompts that work
Copy one into a new chat. Claude reads your profiles, timezone and plan first, so it schedules into slots that actually exist.
Plan the week
“Look at my connected profiles and draft a week of LinkedIn and Instagram posts about our spring launch — one per day. Drafts only.”
Repurpose an article
“Here's our latest article: [link]. Turn it into a LinkedIn post, an X post and a Telegram announcement, within each network's limits. Save as drafts.”
Fix failed posts
“Did anything fail to publish this week? Tell me why, retry what can be retried, and list what needs me.”
Monthly report
“Compare Instagram reach for the last 30 days with the previous 30. Which three posts made the difference?”
Best time to post
“When is my LinkedIn audience most active? Schedule tomorrow's post for the best hour.”
Reuse hashtags
“Save these hashtags as a set called “Spring launch” for our Instagram profile, and use it in the next three drafts.”
Skills for Claude
Add the Onlypult skills to Claude
The connector gives Claude the tools. Skills teach it the workflow around them: the right mode, timezone, limits and fallbacks. Upload the ones you want as skills in Claude.
Upload a skill
Download the repository from GitHub, zip the folder of the skill you want (for example skills/schedule-post) and upload the ZIP in Claude’s skills settings.
Skills in Claude are available on plans that include them. Without skills the connector still works.
Schedule a post
Draft, schedule or publish a post in the right timezone, on the right profile, with plan limits and platform options handled.
Cross-post
Send one message to several networks, checking each platform’s text and media limits first.
Reels, Shorts and Stories
Pick the right tool and flags for Instagram and Facebook Reels, YouTube Shorts and Stories.
Upload media
Choose between a public URL, a browser upload and a direct upload from a local file path.
Fix failed posts
Find what failed, explain why, fix the cause and retry only when a retry can work.
Analytics report
Followers, reach, engagement and top posts, read correctly, with coverage gaps and derived metrics explained.
Best time to post
Find the best days and hours from the engagement heatmap and schedule posts into those slots.
Content calendar
Plan a week or a month around what already works, show the plan first, create posts after you approve.
Your agent gets hands, not the publish button
Most "AI posting" setups are all-or-nothing. Onlypult lets you hand an agent the busywork and keep the final say — on every post.
Drafts by default
Ask for a draft and the agent sends is_draft: true. The post is saved to your calendar and goes nowhere until a person — or an explicit "publish now" — says so.
Per-tool permissions
In Claude, ChatGPT, Cursor and most MCP clients you approve tools one by one. Keep reads and drafts on "Always allow", leave publishing and deleting on "Ask every time".
Everything lands in your calendar
Every post an agent creates shows up in the Onlypult calendar next to your team’s posts. Edit it, reschedule it, or send it through approval before it goes live.
OAuth for chat apps, keys for code
Claude and ChatGPT connect with OAuth 2.1 — you sign in on onlypult.com and the chat app never sees your password. Coding agents use an op_ API key from Settings → API Keys.
Errors an agent can act on
Validation errors come back with a code and a retryable flag. The agent explains "your plan ends on the 5th, pick an earlier date" instead of retrying in a loop.
Prompt-injection aware
Captions and comments pulled in by analytics are marked as untrusted external content, so the agent summarizes them instead of following instructions hidden inside.
Every tool your agent gets
One MCP server covers the whole post lifecycle — context, publishing, media, hashtags, repair and analytics. 37 tools.
Posts & scheduling
14Draft, schedule, publish, cross-post, edit, delete and repair.
posts_createposts_create_storyposts_create_reelsposts_create_shortsposts_publish_nowposts_cross_postposts_listposts_list_failedposts_getposts_updateposts_deleteposts_retryposts_retry_all_failedposts_limits Analytics (read-only)
8Reach, followers, top posts, best time, period over period.
analytics_profiles_listanalytics_metrics_listanalytics_overviewanalytics_audienceanalytics_postsanalytics_top_postsanalytics_best_timeanalytics_compare_periods Account & profiles
6Timezone, plan limits, connected profiles, boards and categories.
account_getprofiles_listprofiles_getprofiles_platforms_listprofiles_get_pinterest_boardsprofiles_get_youtube_categories Hashtag sets
6Reuse saved hashtag groups per profile instead of retyping them.
hashtags_listhashtags_createhashtags_deletehashtag_groups_createhashtag_groups_updatehashtag_groups_delete Media
3Public URLs, browser upload, or direct upload from disk.
media_get_upload_urlmedia_check_statusmedia_upload_file Publish to 15+ networks from one chat
The agent picks profiles from your Onlypult workspace — every account you connected over official OAuth is available, with per-network options like Reels, Shorts, Stories, boards and first comments.
Claude limits and troubleshooting
Free plan: one custom connector
Claude's free accounts can add a single custom connector. Remove the existing one or upgrade to add Onlypult.
Attaching images from your computer
The hosted server runs in the cloud and can't read your disk or files attached to the chat. Two options: give the agent a public image URL (up to 10 per post — Onlypult downloads them), or let it open a one-time upload page via media_get_upload_url, drag the files in, and it picks them up.
Claude doesn't call Onlypult tools
Check the connector shows as connected in Settings → Connectors, start a fresh chat, and ask something that clearly needs Onlypult — for example “list my profiles in Onlypult”.
Authorization fails or loops
Make sure you're signed in to the right Onlypult account. Remove the connector, add it again and click Connect. The consent page should show Allow access.
Analytics profiles are separate
Analytics works for Instagram, Facebook, LinkedIn, TikTok and X profiles connected to Onlypult Analytics. They have their own IDs (prefixed an_), so the agent starts analytics tasks with analytics_profiles_list. Data is refreshed in the background, roughly hourly — it isn't real-time.
Revoking access
Remove the Onlypult connector in Claude's Settings → Connectors. Posts Claude already created stay in your Onlypult calendar.
Claude and social media: FAQ
Can Claude post to social media?
Not on its own — Claude has no access to your social accounts. With the Onlypult connector it can draft, schedule and publish posts to Instagram, Facebook, LinkedIn, TikTok, YouTube, X, Telegram and other networks connected to your Onlypult workspace.
Do I need an API key to use Onlypult in Claude?
No. Claude.ai and Claude Desktop connect through OAuth 2.1 — you sign in to Onlypult and approve access. An API key is only needed if you run the local package from claude_desktop_config.json.
Which Claude plans support the connector?
Any plan that has custom connectors, including Free (one custom connector). On Team and Enterprise, an owner may need to allow custom connectors first.
Can Claude post to Instagram and LinkedIn?
Yes. Claude can create feed posts, multi-image posts, Reels and Stories on Instagram, and posts on LinkedIn profiles and company pages — as drafts, on a schedule, or immediately.
Will Claude publish without asking me?
Only if you allow it. Ask for drafts and nothing goes live. Claude also asks permission per tool — keep publishing and deleting on “ask every time”.
Can Claude attach images to posts?
Yes, by public URL (up to 10 per post) or through a one-time upload page. In Claude Desktop with the local package it can also upload files from a folder on your computer.
Is it free?
MCP is included on every Onlypult plan, including the 7-day free trial with no credit card. Claude itself works on its free plan too.
Connect another AI agent
Custom connector on Plus and Pro, or Developer mode on any plan. OAuth sign-in, then mention @Onlypult.
Setup guideOne command in the terminal. Turn a changelog, a release or a repo into posts without leaving the CLI.
Setup guideAdd Onlypult to .cursor/mcp.json — hosted, or the local package that uploads files straight from disk.
Setup guideAdd Onlypult to the Codex CLI or IDE extension via config.toml or codex mcp add.
Setup guideAdd Onlypult to Cascade in Windsurf via mcp_config.json — hosted or local package.
Setup guideMCP is included on every plan
- Works on the 7-day free trial
- No credit card to start
- No separate developer tier
- No per-profile API fee
Let Claude run your social calendar
Connect in three minutes, ask for a week of drafts, and approve what goes live.
7-day free trial · No credit card · MCP and API on every plan
