Use tinyposter from Claude
Plug tinyposter into Claude (the AI assistant from Anthropic) so you can ask it to post for you in plain English.
What you're building
tinyposter has a built-in MCP server. MCP stands for Model Context Protocol — fancy name for “a way AI assistants talk to tools.” Once you connect it, Claude can post, schedule, and check your calendar by itself.
You need:
- A tinyposter account with at least one social account connected
- One of: Claude Desktop (Mac/Windows), Claude.ai (web), Claude Code (terminal), or Claude Cowork
- About 5 minutes
Step 1 — Get a token
A token is like a password Claude will use to talk to tinyposter. It starts with tp_.
- Open your tokens page.
- Click Create token. Name it “Claude.”
- Copy the token. It only shows once.
Step 2 — Pick where you use Claude
A. Claude Desktop (Mac or Windows)
This is the most popular path. Anyone with Claude Desktop installed can use it.
- 01
Open the config file
Click Claude menu (top-left on Mac, hamburger on Windows) → Settings → Developer → Edit Config. This opens
claude_desktop_config.json.If the menu doesn't open it, you can find it manually:
- Mac:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- Mac:
- 02
Paste this in
Replace the whole file with this (or merge with your existing
mcpServers):claude_desktop_config.jsonjson{ "mcpServers": { "tinyposter": { "url": "https://tinyposter.app/api/mcp", "headers": { "Authorization": "Bearer tp_PASTE_YOUR_TOKEN_HERE" } } } }Replace
tp_PASTE_YOUR_TOKEN_HEREwith the token you copied (keep the wordBearerand the space). - 03
Restart Claude Desktop
Fully quit Claude — Cmd+Q on Mac, right-click the tray icon → Quit on Windows. Just closing the window isn't enough.
Re-open Claude. You'll see a small tools icon in the chat input. Click it — tinyposter should be in the list.
B. Claude.ai (web)
Claude.ai supports custom connectors on Pro, Max, and Team plans.
- 01
Open the connectors page
Click your avatar (bottom-left) → Settings → Connectors. Or jump straight to claude.ai/settings/connectors.
Click Add custom connector.
- 02
Fill in the form
- Name:
tinyposter - Server URL:
https://tinyposter.app/api/mcp - Authentication:
Bearer Token - Token: paste your
tp_…token (noBearerprefix — Claude adds it for you)
Click Save.
- Name:
- 03
Turn it on in a chat
Open a new chat. Click the tools icon in the message box and toggle tinyposter on. It stays on for that chat.
C. Claude Code (terminal)
If you use the Claude Code CLI, one command:
claude mcp add --transport http tinyposter https://tinyposter.app/api/mcp \
--header "Authorization: Bearer tp_PASTE_YOUR_TOKEN_HERE"Restart Claude Code. Inside any session, run /mcp to confirm tinyposter shows up in the list.
D. Claude Cowork
Cowork is Anthropic's collaborative workspace product. If your team uses it, you can add tinyposter as a workspace-level connector so anyone on the workspace can post.
- 01
Open workspace connectors
In Cowork, open the workspace settings → Connectors (sometimes labeled MCP servers) → Add MCP server (or Add custom connector).
- 02
Fill in the form
- Name:
tinyposter - URL:
https://tinyposter.app/api/mcp - Authentication:
Bearer Token - Token: paste your
tp_…token
Save. The connector is live for everyone on the workspace.
- Name:
Step 3 — Try it
In any of the three Claude options above, ask:
What social accounts am I connected to on tinyposter?If it lists your platforms, it works. Now try a real post:
Post "hello from Claude" to my Twitter and LinkedIn using tinyposter.Claude will ask permission the first time it uses a tool. Allow it. The post goes live in about a minute.
Things you can ask Claude
- “Post ‘Friday recap incoming’ to X and LinkedIn.”
- “Schedule a Threads post for Sunday at 9am ET that says...”
- “What's on my schedule next week?”
- “Cancel the post I scheduled for Saturday.”
- “Which platforms am I connected to?”
- “How many posts do I have left this month?”
- “Write a thread about X and post the first tweet to my X account.”
Troubleshooting
▸Claude doesn't see tinyposter after I edit the config
Make sure you fully quit Claude Desktop (Cmd+Q on Mac) and re-open it. Just closing the window isn't enough. The config is only read on launch.
▸It says "Unauthorized" or "401"
Your token is wrong or expired. Go to your tokens page, make a fresh one, and update the config.
▸The config file is messed up — Claude won't start
The file has to be valid JSON. Common mistakes: trailing commas, missing quotes. Paste the snippet above exactly, then change just the token. Or delete the file and Claude will recreate it.
▸I don't have a Developer menu in Claude Desktop
Update Claude Desktop. The Developer settings menu was added in newer versions. Get the latest from claude.ai/download.
▸It says "platform_not_connected"
You asked it to post somewhere you haven't hooked up yet. Go to accounts and connect that platform.
▸Cowork doesn't list tinyposter for my teammates
Cowork connectors are per-workspace, not per-user. The workspace admin needs to add it once on the workspace settings page (Section D above), then everyone in the workspace gets it.
Under the hood
The MCP server is at https://tinyposter.app/api/mcp. It speaks JSON-RPC 2.0 over HTTP. Full tool reference is on the MCP page.
Next
- MCP reference — every tool, every input
- HTTP API — same actions over plain REST
- Codex / coding agents — different agent, same idea