SimplePost + Claude Code

Publish to social media from Claude Code

Turn release notes and repository changes into social posts. Connect SimplePost to preview and schedule the announcement from your terminal.

Connect Claude Code Connect your socials

Connect your social accounts in SimplePost first. 7 days free, no credit card.

Maintained by SimplePost · Updated September 27, 2026

Connect Claude Code

You add SimplePost's hosted server to Claude Code yourself with claude mcp add, then authenticate in the browser. An optional SimplePost plugin for Claude Code is available from SimplePost's own plugin marketplace repository; it is not part of an Anthropic directory.

What you need

Claude Code with remote HTTP MCP server support.
A SimplePost account on the free trial or any paid plan, with social accounts connected in the web app.
For CI or scripts without an assistant, the SimplePost CLI (Advanced and Pro) is the non-interactive alternative.

Add the server
Run this in your terminal. Add --scope user to make it available in every project.
```
claude mcp add --transport http simplepost https://app.simplepost.social/mcp
```
Authenticate
Start Claude Code, run /mcp, choose simplepost and complete the browser sign-in.
```
/mcp
```
Check the connection
Ask Claude Code to list your SimplePost accounts. It should call list_accounts and show real account IDs.
Optional: install the plugin
The plugin bundles the SimplePost skill with the same server configuration.
```
/plugin marketplace add simple-post/simplepost-claude-plugin
/plugin install simplepost@simplepost
```

New to SimplePost? <link>Connect your social accounts first</link>.

Workflow

Example: announce a release from the repository

Run these prompts in the repository you are releasing. Claude Code reads local files for context; the media it sends to SimplePost must be a public URL, because the hosted server cannot read your disk.

1. Gather the release context

Read CHANGELOG.md and the commits since the v2.3.0 tag. Summarize what changed in v2.4.0 for users, not developers.

Result: Claude Code reads the files and git log and returns a user-facing summary you can correct.

2. Draft per-network versions

List my SimplePost accounts. Draft one SimplePost post for the release: a single post for LinkedIn, and a three-part thread for X and Bluesky using per-account overrides. Link to the GitHub release page. Save it as a draft and show the preview.

Result: A single draft with overrides is saved, and the preview text is returned for each network.

3. Schedule for the release

Schedule that draft for 15:00 UTC today, when the release goes live. Use a new idempotency key.

Result: The draft becomes a scheduled post; Claude Code reports the exact time and accounts.

4. Check it went out

After 15:00, inspect the post and tell me the result for each account, with links.

Result: Per-account results with post URLs, or the exact error for any account that failed.

Publishing details

What Claude Code can do

Draft announcements from CHANGELOG.md, release tags, commit messages or pull request descriptions.
Create per-network versions: a technical thread for X and Bluesky, a summary for LinkedIn.
Save drafts for review, show previews, and schedule them for the release time.
Check what is already scheduled and edit or discard posts before they go out.

Connect social accounts in the SimplePost web app. Engagement analytics and changes to already published posts stay on the social network.

Different versions for each network

Release announcements usually need two shapes: a technical thread for developer audiences and a single summary elsewhere. Claude Code can produce both in one post with per-account overrides.
Ask it to keep version numbers, links and product names exactly as they appear in the repository, and to show you every version before scheduling.

Sign-in and permissions

Claude Code uses OAuth with the hosted server; there is no API key to paste into a config file or commit by accident.
The token is stored by Claude Code and expires after 90 days. Re-run /mcp to sign in again.
For a self-hosted SimplePost, replace the URL with your deployment's /mcp endpoint.

Publishing actions and tools

What Claude Code can do at each stage
Preview	preview_post and show_post_preview; in the terminal you get the text result for each network.
Schedule	create_post with a scheduled time; a new idempotency key per intended post makes retries safe.
Publish now	create_post with posting mode now, for example right after a deployment finishes.
View scheduled posts	get_schedule for the calendar data; inspect_posts for scheduled posts.
Update or cancel	update_scheduled_post or discard_scheduled_post before the post starts publishing, for example if a release slips.

If something does not work

simplepost shows as needing authentication

Run /mcp in Claude Code, select simplepost and complete the browser flow.

Claude Code wants to attach a local screenshot

The hosted server cannot read local files. Upload the image somewhere public (for example the GitHub release assets), or add it in the web composer.

A retry created a duplicate

Ask Claude Code to reuse the same idempotency key when retrying a write that timed out; a new key means a new post.

Supported platforms

Networks Claude Code can publish to

All ten hosted networks work the same way from Claude Code: X, LinkedIn, Instagram, Facebook, Threads, Bluesky, TikTok, YouTube, Pinterest and Telegram. These platform guides are most relevant here:

Compare all supported platforms

FAQ

Claude Code and SimplePost questions

How do I add SimplePost to Claude Code?

Run claude mcp add --transport http simplepost https://app.simplepost.social/mcp, then run /mcp inside Claude Code and sign in to SimplePost in the browser.

Can Claude Code post release notes automatically?

It can draft and schedule them when you ask in a session. For unattended CI jobs, use the SimplePost CLI or API instead of an interactive assistant.

Can Claude Code upload images from my repository?

Not directly to the hosted server, which cannot read local paths. Use a public URL for the image or upload it in the SimplePost web app.

Is there an official Claude Code plugin?

SimplePost publishes a plugin in its own marketplace repository, simple-post/simplepost-claude-plugin. It is maintained by SimplePost, not by Anthropic.