Your social media. Now in Claude.
The SocialDesk MCP server connects Claude to your social accounts. Connect it once, then schedule posts, generate content, check analytics, and reply to DMs and comments — in plain language.
Server URL
Connected in under a minute.
No API keys, no config files to hand-edit. Add the connector, sign in with your SocialDesk account, done.
claude.ai — web & mobile
Custom connectors require a paid Claude plan.
- 1Open Settings → Connectors and click “Add custom connector”.
- 2Name it SocialDesk and paste the server URL. Leave the OAuth fields empty.
- 3Click Add, then Connect — you're redirected to your SocialDesk sign-in.
- 4Log in and you're linked. The tools are available in every chat.
Claude Desktop
Same connector flow, in the native app.
- 1Open Settings → Connectors in the desktop app.
- 2Add a custom connector with the server URL.
- 3Connect and sign in with your SocialDesk account.
Claude Code
For the terminal.
- 1Run the command below in any project.
- 2Type /mcp to authenticate, then just ask.
claude mcp add --transport http socialdesk https://app.socialdesk.ai/api/mcp
OAuth, not API keys.
The connector authenticates with OAuth 2.1 (PKCE and dynamic client registration). You sign in with your SocialDesk account — there are no keys to copy, every tool call runs as you, and you can revoke access at any time by disconnecting. On top of that, Claude gates every tool behind its own permission system: read-only tools and write actions are approved separately.
Just say it.
“List my connected accounts”
Shows every social account linked to your space, across all platforms.
“What's scheduled this week?”
Reads your scheduled posts with dates, captions, and platforms.
“Schedule a LinkedIn post tomorrow at 11am with an AI image”
Generates the caption and image with SocialDesk AI, then schedules the post.
“Any DMs I haven't answered?”
Sweeps your unified inbox and drafts replies you can approve.
21 tools, generated from our API.
Every tool is generated from the same OpenAPI spec that powers our REST API — when the API grows, the connector grows with it. GET tools are read-only; anything that writes asks for your approval in Claude.
Posts & drafts (9)
list_postsList the user's posts in SocialDesk: scheduled (queued, not live yet), published or failed. Filter by spaceId and status. Set includeImported to also see posts the accounts published outside SocialDesk in the last 30 days (read-only, negative ids). Stories are left out unless includeStories is true.
get_a_postGet one post by id: caption, media, target account, status, scheduled or published time, and the error message if publishing failed.
update_a_postEdit a scheduled post before it goes out: caption, medias, scheduledDate (ISO 8601; a new date reschedules it) or firstComment. Only the fields you pass change. Editing a post that is already published only updates SocialDesk's copy, not the live post.
delete_a_postDelete a post from SocialDesk. Deleting a scheduled post cancels it, so it is never published. Deleting a published post only removes it from SocialDesk; it stays live on the social network. This can't be undone, so confirm with the user first.
get_post_insightsGet live engagement metrics for a published post (such as likes, comments, shares and views, depending on the platform). If the account needs reconnecting or the post was deleted on the platform, the response says so instead.
list_draftsList the user's drafts: posts saved in SocialDesk without being published or scheduled, most recently edited first.
create_a_draftSave a post as a draft in a space, so the user can review and finish it later in SocialDesk. Nothing is posted or scheduled. selectedAccountIds are the accounts it is meant for (ids from list_connected_social_accounts_in_a_space); mediaUrls must be public HTTPS links.
update_a_draftChange a draft's caption, media or target accounts. Only the fields you pass change; mediaUrls and selectedAccountIds replace the current lists. Nothing is posted.
delete_a_draftDelete a draft. It can't be recovered, so confirm with the user first.
Publishing & media (1)
publish_a_post_to_one_or_more_connected_accountsPublish a post now, or schedule it, on one or more connected accounts. Each entry in targets is one account (socialAccountId from list_connected_social_accounts_in_a_space). text and mediaUrls apply to every target unless that target's overrides set its own. Omit scheduledFor to publish immediately; set it (ISO 8601 with a time zone offset) to schedule. mediaUrls must be public HTTPS links to images or videos; some platforms, such as Instagram and TikTok, require media. Publishing is public and can't be undone: show the user the final text, media, accounts and time, and get their confirmation before calling. The response has one result per target, so report any that failed.
Inbox (5)
list_dm_conversations_across_all_accounts_in_a_spaceList direct-message conversations (Instagram, Facebook, WhatsApp) across every account in a space, newest first. Each conversation has an id (the conversationId), an accountId and a participant whose id is the recipientId for replies.
get_messages_in_a_conversationRead the messages in one direct-message conversation. Pass the conversationId and accountId from list_dm_conversations_across_all_accounts_in_a_space.
send_a_direct_messageReply in an existing direct-message conversation as the connected account. Pass conversationId, accountId and recipientId (the conversation's participant id). Platforms only accept replies within their messaging window (on Instagram and Facebook, 24 hours after the person's last message), and Instagram group threads can't be replied to. The message is delivered immediately and can't be unsent: confirm the exact text with the user first.
list_comments_on_a_published_postList the comments, with their replies, on a published post (by SocialDesk post id). If the account needs reconnecting or the post was deleted on the platform, the response says so instead.
comment_on_a_post_or_reply_to_a_commentPost a comment on a published post as the connected account, or reply to an existing comment by passing its commentId (from list_comments_on_a_published_post). Comments are public immediately: confirm the exact text with the user first.
Analytics & dashboard (2)
dashboard_overview_for_a_spaceSummarise a space's performance and activity: audience and engagement KPIs, the upcoming queue, failed posts and per-account stats. Optionally filter by platform; timeRange is week (default), month or all.
per_account_analytics_insightsDetailed analytics for one connected account (accountId from list_connected_social_accounts_in_a_space): profile metrics and recent posts' performance, using the platform's own metric names.
AI generation (2)
generate_a_post_captionWrite a social media caption from a short brief, optionally with a matching AI image returned as a public URL that can be used in mediaUrls. generateImage defaults to true; pass false when the user only wants text. If the image fails, the caption is still returned. Nothing is posted.
generate_hashtags_for_some_textSuggest relevant hashtags for a caption or topic. Nothing is posted.
Social accounts (1)
list_connected_social_accounts_in_a_spaceList the social accounts (e.g. Instagram, Facebook, LinkedIn, X, TikTok) connected to a space, with their platform and username. Use an account's id as socialAccountId when publishing, and as accountId for analytics and direct messages.
Spaces & team (1)
list_spacesList the user's SocialDesk spaces. A space is a workspace that groups one brand's social accounts. Call this first: most other tools need a spaceId from here.
Common questions.
What is the SocialDesk MCP server?
The SocialDesk MCP server is the official Model Context Protocol connector for SocialDesk. It lets Claude (claude.ai, Claude Desktop and Claude Code) schedule and publish posts, manage drafts, read analytics and answer your inbox on your SocialDesk account, using 21 tools and a secure OAuth sign-in.
Do I need an API key to connect Claude?
No. The connector uses OAuth: you sign in with your SocialDesk account during setup and can revoke access at any time by disconnecting. API keys exist too, but they are for the REST API and local integrations.
Which Claude plans support the connector?
Custom connectors on claude.ai and Claude Desktop require a paid Claude plan (Pro, Max, Team or Enterprise). Claude Code supports MCP servers on any plan.
What can Claude do with my account?
Everything the SocialDesk API exposes: schedule and publish posts, manage drafts, read analytics and the dashboard, browse and answer your unified inbox, and generate content with SocialDesk AI. Read-only tools and write actions are approved separately in Claude, and destructive actions always ask first.
Does it cost anything extra?
No. The connector is free and uses your existing SocialDesk account and plan — tool calls count against the same quotas as the web app.
Talk to your social media. Starting today.
Free to set up — the connector uses your existing SocialDesk account and plan.