Claude Code + PostAxis

Post to social media with Claude Code

Ship a release, then ship the announcement. Claude Code already knows what changed in your repo; with PostAxis it can turn the diff into posts and schedule them across your channels.

One command, OAuth sign-in in your browser
Turn commits and changelogs into posts
Schedule launches from the terminal

Connect Claude Code Start for $0

Set up Claude Code with PostAxis

Plug PostAxis into Claude Code once, then talk to it like you would to whoever runs your accounts. Every click is in the full guide below.

Plug in about a minute

Step 1 of 2

Add PostAxis with one command

Register the remote MCP server from your terminal, then authenticate inside Claude Code. Your browser handles the sign-in.

PostAxis account
A connected social account
Claude Code installed

Terminal

claude mcp add --transport http postaxis https://postaxis.io/api/mcp

Add --scope user to make PostAxis available in every project.

Talk

Step 2 of 2

Then tell Claude Code what you need

Claude Code picks the PostAxis tools it needs. Scheduled posts go out on time whether or not the chat is still open.

Try asking

Which accounts can you post to?
What goes out this week?
Keep that one as a draft

Read CHANGELOG.md and schedule a short X post and a LinkedIn post about v2.4 for 17:00 today.

Scheduled for 17:00 today: an X post (238 characters) and a LinkedIn post. Both passed the rules check. Post IDs are in the output above.

via PostAxis

Example answer · lands in your PostAxis calendar

Full setup guide for Claude Code

Every step from a new PostAxis account to your first scheduled post. Takes about a minute once your accounts are connected. Want ready-made workflows? Read the full Claude Code guide

1
Create your PostAxis account
Sign up at app.postaxis.io. Every plan starts with a 7-day free trial and includes MCP access with OAuth sign-in. Create an account
2
Connect your social accounts
Open Accounts in PostAxis and connect the networks you want to post to: Instagram, TikTok, YouTube, X, LinkedIn, Facebook, Threads or Telegram. Your agent can only post to accounts connected here, and it never sees your social media passwords. Open Accounts
3
Add the server
Run this in your terminal. Add --scope user to make PostAxis available in every project instead of just the current one.
Copy this
```
claude mcp add --transport http postaxis https://postaxis.io/api/mcp
```
4
Authenticate
Start Claude Code, type /mcp, select postaxis and choose Authenticate. Your browser opens the PostAxis sign-in; log in and click Approve.
5
Check it’s connected
Run /mcp again. postaxis should show as connected with 11 tools.
6
Ask for a post
Ask in plain language, for example “post today’s release notes to X and LinkedIn at 5pm”. Claude Code asks permission before calling tools.

What can Claude Code do with PostAxis?

Everything PostAxis does in the dashboard that makes sense to do by asking: writing, scheduling, editing, publishing and checking your queue.

Sentences in, posts out

Describe the post in your own words. Claude Code turns it into posts and PostAxis handles the scheduling.

Every network you run

Instagram, TikTok, YouTube, X, LinkedIn, Facebook, Threads and Telegram, from a single message.

Checked before it’s saved

Caption length, media count, video length and format are checked for every network before anything is saved.

Weeks ahead in one go

Ask for a week or a month. Claude Code can dry-run up to 50 posts at once, show you the plan, then schedule it.

Your images and video

Attach images and videos from a link, or get a one-time upload link for files on your computer.

Your accounts, your call

Claude Code signs in as you and can only reach accounts connected in your workspace. Cut it off from Settings whenever you like.

What is Claude Code?

Claude Code is Anthropic’s agentic coding tool. It runs in your terminal and IDE, understands your codebase, runs commands and calls MCP tools on your behalf.

Because it already knows what changed in your repository, it is a natural place to write release posts. With PostAxis it can schedule them before you leave the terminal.

What can you ask Claude Code to post?

Brief it like a person: what it’s about, where it goes, when. Four requests that work well with Claude Code:

Release notes
Turn a release into posts
Read CHANGELOG.md, write an X post and a LinkedIn post about this release and schedule both for 17:00 today.
To Claude Code
From a pull request
Announce what you merged
Summarise the feature in this branch as a short X post and a Threads post, and schedule them for tomorrow at 10:00.
To Claude Code
Weekly digest
Post a weekly changelog
Summarise this week’s commits as a “what’s new” post and publish it to Telegram and LinkedIn now.
To Claude Code
Check the queue
Fix what won’t publish
List my scheduled posts for this week and fix any that break Instagram’s or X’s rules.
To Claude Code

How does Claude Code talk to PostAxis?

Through MCP, the Model Context Protocol: an open standard for giving AI apps tools. PostAxis runs an MCP server; Claude Code connects to it and gets 11 tools that work on your account, nothing more. Full MCP reference

From your message to a scheduled post

What happens between you hitting enter and the post showing up in your calendar.

You write one message: what, where, when
Claude Code looks up your accounts and the limits of each network you named
It drafts a version per network and sends them to PostAxis
PostAxis checks every version and saves it as scheduled, a draft or live
The post sits in your calendar, editable until it goes out

Claude Code + PostAxis

Server: https://postaxis.io/api/mcp
Transport: Streamable HTTP
Sign-in: OAuth 2.1

Tools Claude Code discovers

list_workspacesYour PostAxis workspaces
list_accountsConnected social accounts per workspace
get_platform_rulesCaption limits and media rules per network
upload_media_from_urlPull an image or video into your media library
create_upload_linkOne-time link for uploading a local file
create_postDraft, schedule or publish one post
create_posts_bulkSchedule up to 50 posts in one call
list_postsPosts by status or date range
get_postOne post with its per-network status
update_postEdit text, media or time before it goes out
delete_postRemove a draft or scheduled post

Can Claude Code post from a CI job or script?

Yes. Run Claude Code non-interactively (claude -p) in your pipeline with PostAxis configured. For machines with no browser, use an API key in the server headers instead of OAuth.

Write an X post about the release in CHANGELOG.md and schedule it for 17:00 UTC.

Done. Here’s what I did:

Read CHANGELOG.md
Scheduled 1 X post for 17:00 UTC
Printed the post ID so the pipeline can log it

via PostAxis

Example conversation

Does Claude Code write a different version for each network?

It can, and it should: X counts characters, LinkedIn rewards a longer read, Telegram has no title. Name the networks in one request and Claude Code sends one post with a version per network. PostAxis rejects any version that breaks that network’s limits before it is saved.

Share the 2.0 release with the screenshot from our blog: a punchy line on X, a short story on LinkedIn, the full changelog on Telegram. All at 14:00.

Done. Here’s what I did:

X: 1 post, 212 characters, screenshot attached
LinkedIn: 1 post, 4 short paragraphs, screenshot attached
Telegram: the full changelog, screenshot attached
Scheduled together for 14:00, one post ID

via PostAxis

Example conversation

How does Claude Code sign in to PostAxis?

Claude Code signs in to PostAxis, never to your social networks. Your Instagram, X or LinkedIn accounts stay connected to PostAxis, and you can revoke Claude Code’s access at any time.

Every plan✓ Used by Claude Code

OAuth sign-in

Claude Code opens the PostAxis sign-in in your browser
You log in and click Approve
It gets access to your account only, until you revoke it

Best for apps you use yourself: ChatGPT, Claude, Cursor, Codex and most others

API add-on

API key

Create a key under Settings → API keys
Send it as Authorization: Bearer KEY, or in the URL for clients that only take a URL
Revoke the key any time and access stops at once

Best for servers and automations with no browser: n8n, Grok, Manus, headless agents

If something doesn’t work

The most common problems when connecting Claude Code, and how to fix them.

The agent says no accounts are connected

Connect at least one social account under Accounts in PostAxis. If you use several workspaces, tell the agent which one, for example “use my Acme workspace”.

401 Unauthorized or “sign in again”

The sign-in expired or was revoked. Reconnect from your agent (it opens the PostAxis sign-in again). With an API key, check the key is still active under Settings → API keys.

A post was rejected before saving

PostAxis checks each network’s rules first: caption length, media count, video length and format. The error says what to change; ask the agent to fix it and try again.

Posts are scheduled at the wrong time

Say the timezone in your request, for example “9:00 Europe/Berlin”. Without one, the agent uses the timezone it was told or UTC.

I want to stop an agent from posting

Open Settings → API keys in PostAxis. Revoke the agent under Connected agents, or revoke its API key. It loses access immediately.

Claude Code and PostAxis: questions

Does it work with the Claude Code VS Code and JetBrains extensions?

Yes. MCP servers added to Claude Code are available wherever Claude Code runs, including the IDE extensions.

Where is the login stored?

Claude Code stores the PostAxis OAuth token in its own credential store. You can revoke it any time in PostAxis under Settings → API keys → Connected agents.

Can I use an API key instead of OAuth?

Yes, for headless setups: claude mcp add --transport http postaxis https://postaxis.io/api/mcp --header "Authorization: Bearer YOUR_API_KEY". API keys need the PostAxis API add-on.

What is the PostAxis MCP server?

It’s a remote Model Context Protocol server at https://postaxis.io/api/mcp that gives AI agents 11 tools to list your accounts, upload media and create, schedule, edit and delete posts in PostAxis.

Which social networks are supported?

Instagram (posts, Reels, carousels), TikTok (videos and photo posts), YouTube Shorts, X, LinkedIn, Facebook Pages, Threads and Telegram channels.

How much does it cost?

MCP access with OAuth is included in every PostAxis plan, and every plan starts with a 7-day free trial. API keys need the API add-on.

What stops an agent from posting something wrong?

PostAxis checks every post against each network’s rules before saving, the agent can preview bulk plans without saving them, everything shows up in your calendar, and you can revoke an agent at any time in Settings → API keys.