How do I install Postbolt?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Postbolt need an API key?

The publisher lists these environment variables: POSTBOLT_API_KEY.

What transport does Postbolt use?

Postbolt runs locally over stdio.

When was Postbolt last checked?

Last checked 2026-11-09. Publish to 13+ social media platforms from any AI agent via MCP.

Postbolt MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Credentials from the publisher

POSTBOLT_API_KEY — Your PostBolt API key (starts with sk_)

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1POSTBOLT_API_KEY=<secret> claude mcp add io.github.whitemarmot-postbolt -- npx -y postbolt-mcp@1.0.2

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.whitemarmot-postbolt": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "POSTBOLT_API_KEY": "<secret>"11      }12    }13  }14}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.0.2
API key

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

postbolt-mcp

MCP server for PostBolt - publish to social media from any AI agent.

This package lets MCP-compatible clients (Claude Desktop, Claude Code, Cursor, Windsurf) schedule and publish posts to 13+ social platforms through PostBolt's API with zero code.

Setup

Get your API key at postbolt.dev
Add to your MCP client config:

{
  "mcpServers": {
    "postbolt": {
      "command": "npx",
      "args": ["-y", "postbolt-mcp"],
      "env": {
        "POSTBOLT_API_KEY": "sk_..."
      }
    }
  }
}

Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

Claude Code: ~/.claude/settings.json under mcpServers

Tools

publish_post

Publish a post immediately to one or more platforms.

Parameter	Type	Required	Description
content	string	yes	The text content
platforms	string[]	yes	Platforms to publish to
media_id	number	no	ID from upload_media
custom_content	object	no	Platform-specific overrides

schedule_post

Schedule a post for future publication.

Parameter	Type	Required	Description
content	string	yes	The text content
platforms	string[]	yes	Platforms to publish to
scheduled_for	string	yes	ISO 8601 datetime
media_id	number	no	ID from upload_media
custom_content	object	no	Platform-specific overrides

list_posts

List your posts with optional filtering.

Parameter	Type	Required	Description
page	number	no	Page number
status	string	no	Filter: pending, scheduled, published, partial, failed

get_post

Get detailed info about a post including per-platform results.

Parameter	Type	Required	Description
post_id	number	yes	The post ID

update_post

Update a scheduled post's content or time.

Parameter	Type	Required	Description
post_id	number	yes	The post ID
content	string	no	New text content
custom_content	object	no	New platform overrides
scheduled_for	string	no	New ISO 8601 datetime

cancel_post

Cancel a scheduled post (refunds your post quota).

Parameter	Type	Required	Description
post_id	number	yes	The post ID

upload_media

Upload an image to attach to posts (JPEG, PNG, GIF, WebP, max 10MB).

Parameter	Type	Required	Description
file_path	string	yes	Absolute path to the image

Resources

Resource	URI	Description
Profile	postbolt://profile	Your plan, quota, and allowed platforms
Accounts	postbolt://accounts	Connected social media accounts

Supported Platforms

twitter, linkedin, facebook, instagram, threads, tiktok, pinterest, bluesky, telegram, youtube, reddit, google_business, snapchat

Platform availability depends on your PostBolt plan.

Examples

Publish to Twitter and LinkedIn:

"Post 'Just shipped v2.0!' to Twitter and LinkedIn"

Schedule with platform-specific content:

"Schedule a post for tomorrow at 9am: 'Big news coming' on Twitter, 'We are excited to announce our latest update' on LinkedIn"

Upload an image and post:

"Upload /tmp/screenshot.png and post it to Instagram with caption 'Check this out'"

License

MIT

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Postbolt?

Does Postbolt need an API key?

What transport does Postbolt use?

When was Postbolt last checked?

Documentation

postbolt-mcp

Setup

Tools

publish_post

schedule_post

list_posts

get_post

update_post

cancel_post

upload_media

Resources

Supported Platforms

Examples

License