How to post to X (Twitter) from Claude Desktop

1. 1

   Create an API key and add planpo.st to Claude Desktop

   Make a scoped key in planpo.st under Settings. Open Settings, then Connectors, then Add custom connector, and enter the planpo.st URL with an Authorization header. Or add the local npx entry to claude_desktop_config.json and restart the app, since it reads that file only on launch.

2. 2

   Confirm the server is connected

   Start a new chat and check that the planpost tools appear in the tools menu.

3. 3

   Connect X

   Connect the X account in the planpo.st dashboard under Connections. OAuth needs a person at a browser, so the agent cannot do this part alone; it can call get_connection_link and hand you the URL to open.

4. 4

   Know what the post needs

   An X post needs text of 280 characters or fewer with no URL in it. That includes bare domains such as example.com, which X turns into links by itself. Nothing in platformSettings is required.

5. 5

   Ask in a chat window

   Say what to post and when. Claude Desktop finds the X connection, creates the post, and tells you whether it was scheduled or kept as a draft, with the reason.

Settings -> Connectors -> Add custom connector

Name:  PlanPost
URL:   https://mcp.planpo.st/mcp

Then add the header:
Authorization: Bearer pk_live_xxx

{
  "mcpServers": {
    "planpost": {
      "command": "npx",
      "args": ["-y", "planpost-mcp"],
      "env": { "PLANPOST_API_KEY": "pk_live_xxx" }
    }
  }
}

There is nothing to upload for X, since posts go out as text. When the same post also targets a network that takes images, Claude Desktop sets platformMedia so the picture goes there and X gets the words.