socialclaw — Claude Code MCP server: post scheduling
Wires your agent to social accounts through a hosted service: schedule, publish, inspect. Needs a workspace key and an active plan.
claude mcp add socialclaw -e SOCIALCLAW_API_KEY=<SOCIALCLAW_API_KEY> -- npx -y socialclawWhat socialclaw does
socialclaw is an MCP server that hands your agent 17 publishing tools tied to the accounts in your workspace: list accounts and their capabilities, upload media, validate and preview a schedule, apply it with idempotency keys, publish drafts, and inspect posts, attempts, runs, analytics, usage and workspace health. Everything runs against the hosted SocialClaw service, not on your machine.
The server starts with npx -y socialclaw mcp. Your key goes in through SOCIALCLAW_API_KEY. Ran socialclaw login --api-key <key> earlier? Then the saved credentials are picked up and the env block can be dropped. A key by itself won't get you far: the workspace also needs an active trial or paid plan, or commands come back with plan_required or subscription_*.
Account connections use browser OAuth, except Discord and Telegram, which are wired by hand — a webhook URL for one, a bot token plus chat-id for the other. Schedules are accepted as JSON or YAML. The package installs globally with npm install -g socialclaw, or as an agent skill via npx skills add ndesv21/socialclaw.
What it helps with
- queue posts to several networks from one schedule file
- upload an image and attach it to a post
- catch schedule errors before anything goes out
- check how a published post was delivered
- remove a published post on the provider side
Example prompts for the agent
- List my connected accounts and what each one supports
- Validate
schedule.jsonand show me the campaign preview - Upload
./image.pngand queue a post with it
How to install socialclaw
1Platform CLI
claude mcp add socialclaw -e SOCIALCLAW_API_KEY=<SOCIALCLAW_API_KEY> -- npx -y socialclawReplace <…> with your own values
2Platform CLI: remote server
claude mcp add --transport http socialclaw https://getsocialclaw.com/mcp1Platform CLI: remote server
codex mcp add socialclaw --url https://getsocialclaw.com/mcp2Platform CLI
codex mcp add socialclaw --env SOCIALCLAW_API_KEY=<SOCIALCLAW_API_KEY> -- npx -y socialclawReplace <…> with your own values
Config file
{
"mcpServers": {
"socialclaw": {
"url": "https://getsocialclaw.com/mcp"
}
}
}{
"mcpServers": {
"socialclaw": {
"command": "npx",
"args": [
"-y",
"socialclaw"
],
"env": {
"SOCIALCLAW_API_KEY": "<SOCIALCLAW_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"socialclaw": {
"type": "http",
"url": "https://getsocialclaw.com/mcp"
}
}
}{
"servers": {
"socialclaw": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"socialclaw"
],
"env": {
"SOCIALCLAW_API_KEY": "<SOCIALCLAW_API_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http socialclaw https://getsocialclaw.com/mcp2Platform CLI
gemini mcp add -e SOCIALCLAW_API_KEY=<SOCIALCLAW_API_KEY> socialclaw npx -y socialclawReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about socialclaw
How do I install socialclaw in Claude Code?
Run claude mcp add socialclaw -e SOCIALCLAW_API_KEY=<SOCIALCLAW_API_KEY> -- npx -y socialclaw. The agent then sees the SocialClaw tools.
What does socialclaw do?
It gives an agent tools for social publishing: account listing, media upload, schedule validation and apply, draft publishing, plus post and analytics inspection.
What do I need for socialclaw to work?
A workspace key and an active trial or paid plan. Without a plan, commands return plan_required or subscription_*.
