SocialDesk — AI social media management tool
Get Started
SocialDesk MCP server

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

Setup

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.

  1. 1Open Settings → Connectors and click “Add custom connector”.
  2. 2Name it SocialDesk and paste the server URL. Leave the OAuth fields empty.
  3. 3Click Add, then Connect — you're redirected to your SocialDesk sign-in.
  4. 4Log in and you're linked. The tools are available in every chat.

Claude Desktop

Same connector flow, in the native app.

  1. 1Open Settings → Connectors in the desktop app.
  2. 2Add a custom connector with the server URL.
  3. 3Connect and sign in with your SocialDesk account.

Claude Code

For the terminal.

  1. 1Run the command below in any project.
  2. 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.

In practice

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.

Tool reference

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)

getlist_posts

List 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.

getget_a_post

Get one post by id: caption, media, target account, status, scheduled or published time, and the error message if publishing failed.

patchupdate_a_post

Edit 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.

deletedelete_a_post

Delete 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.

getget_post_insights

Get 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.

getlist_drafts

List the user's drafts: posts saved in SocialDesk without being published or scheduled, most recently edited first.

postcreate_a_draft

Save 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.

patchupdate_a_draft

Change a draft's caption, media or target accounts. Only the fields you pass change; mediaUrls and selectedAccountIds replace the current lists. Nothing is posted.

deletedelete_a_draft

Delete a draft. It can't be recovered, so confirm with the user first.

Publishing & media (1)

postpublish_a_post_to_one_or_more_connected_accounts

Publish 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)

getlist_dm_conversations_across_all_accounts_in_a_space

List 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.

getget_messages_in_a_conversation

Read the messages in one direct-message conversation. Pass the conversationId and accountId from list_dm_conversations_across_all_accounts_in_a_space.

postsend_a_direct_message

Reply 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.

getlist_comments_on_a_published_post

List 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.

postcomment_on_a_post_or_reply_to_a_comment

Post 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)

getdashboard_overview_for_a_space

Summarise 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.

getper_account_analytics_insights

Detailed 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)

postgenerate_a_post_caption

Write 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.

postgenerate_hashtags_for_some_text

Suggest relevant hashtags for a caption or topic. Nothing is posted.

Social accounts (1)

getlist_connected_social_accounts_in_a_space

List 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)

getlist_spaces

List 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.

FAQ

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.