Skip to content
SocialHelper
Get API key

MCP client

Claude Desktop + SocialHelper

Add the SocialHelper MCP server to Claude Desktop and your agent can list your accounts, check each platform’s rules, publish posts and run data tools, asking you before it posts.

Get a free API key About the MCP server
Checked against Claude Desktop’s docs on October 10, 2026

Setup

Set it up in Claude Desktop.

Replace YOUR_API_KEY with your key, or keep the key in an environment variable as shown.

There’s deliberately no space after “Authorization:”. It avoids an argument-escaping bug in Claude Desktop on Windows.
Custom connectors in Claude Desktop and claude.ai sign in with OAuth, or send headers through a beta only some organizations have. One-click SocialHelper connectors are coming soon.

Source: Claude Desktop documentation ↗

  1. 1

    Create an API key

    In the SocialHelper dashboard, open Developers and create a key. It starts with sh_ and is shown once, so copy it somewhere safe.

  2. 2

    Connect through mcp-remote

    Claude Desktop’s config file starts local servers, so it reaches SocialHelper through the mcp-remote bridge, which needs Node.js. Add this to claude_desktop_config.json, then restart Claude Desktop.

    {
  "mcpServers": {
    "socialhelper": {
      "command": "npx",
      "args": ["mcp-remote", "https://socialhelper.app/mcp", "--header", "Authorization:${SH_AUTH}"],
      "env": { "SH_AUTH": "Bearer YOUR_API_KEY" }
    }
  }
}
  3. 3

    Try it

    Ask: “List my SocialHelper accounts.” Claude Desktop calls list_accounts and shows the accounts you connected.

What your agent gets

9 tools.

Every tool runs with your API key and is limited to your workspace.

list_accounts

List the accounts connected to this workspace. Accounts with can_publish receive posts: use their IDs as `accounts` in create_post. Accounts with tools (Search Console, Analytics, Ads…) offer reports and lookups: see list_account_tools. Only accounts with status "active" can be used.

get_platform_rules

Get the rules posts must fit on each platform: text limit and how it is counted, how many images/videos, accepted file types and sizes, and platform-specific options you can pass in create_post overrides.

upload_media

Import an image or video from a public URL so it can be attached to a post. Returns a media ID for create_post. Accepts JPEG, PNG, WebP, GIF, MP4 and MOV up to 60 MB.

create_post

Publish a post to one or more connected accounts, now or at scheduled_at. The content is checked against every target platform first: if anything does not fit, nothing is posted and all problems are returned. Posting is public — confirm the text and accounts with the user first.

get_post

Get a post and the status of each target account: scheduled, queued, publishing, confirming, published (with its live URL), failed (with the reason) or cancelled.

list_posts

List recent posts, newest first, optionally filtered by status. Useful for finding scheduled posts or recent failures.

cancel_post

Cancel a scheduled post on every account where it has not started publishing. Already-published targets are not removed from the platform.

list_account_tools

List the tools a connected account offers, such as Search Console queries, Analytics reports or Google Ads searches, with each tool's input schema. Run them with run_account_tool. Accounts that only receive posts have no tools.

run_account_tool

Run one of a connected account's tools (see list_account_tools) and get its result. Pass the tool's input as `input`, matching its input schema.

Ship it from Claude Desktop.

Create a free account, connect an account and send your first post in a few minutes.

Get a free API key Read the docs