Use tinyposter from Claude

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_.

1. Open your tokens page.
2. Click Create token. Name it “Claude.”
3. 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.

→ Install for me (30 seconds)

1. 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
2. 02

   Paste this in

   Replace the whole file with this (or merge with your existing mcpServers):

   claude_desktop_config.jsonjson

   Copy

   {
     "mcpServers": {
       "tinyposter": {
         "url": "https://tinyposter.app/api/mcp",
         "headers": {
           "Authorization": "Bearer tp_PASTE_YOUR_TOKEN_HERE"
         }
       }
     }
   }

   Replace tp_PASTE_YOUR_TOKEN_HERE with the token you copied (keep the word Bearer and the space).

3. 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, Team, and Enterprise plans. Uses OAuth, no token to copy.

→ Install for me (30 seconds)

1. 01

   Open the connectors page

   Click your avatar (bottom-left) → Settings → Connectors. Or jump straight to claude.ai/settings/connectors.

   Click Add custom connector.

2. 02

   Paste the URL, that's it

   • Name: tinyposter
   • URL: https://tinyposter.app/api/mcp
   • Advanced settings: leave blank.

   Click Add.

3. 03

   Allow tinyposter

   A tinyposter window pops up asking if you want to let Claude use your account. Click Allow. Make sure you're signed into tinyposter in this browser, if not, you'll see the login screen first.

4. 04

   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 Claude Code, paste one setup message into the Claude Code chat. Claude Code can run the right MCP command for you and keep the token out of git-tracked project files.

→ Install for me (30 seconds)

Install this Tinyposter MCP server for me in this AI tool.

Server name: tinyposter
Server URL: https://tinyposter.app/api/mcp
Authorization header: Bearer tp_PASTE_YOUR_TOKEN_HERE

Use the local/user MCP configuration for whichever tool this chat is running in:
- Claude Code: add a remote HTTP MCP server named "tinyposter" with the URL and Authorization header above. Use local/project scope if available, so the token is not written to a shared repo file.
- Codex CLI: add the equivalent server to my local Codex MCP config:
  [mcp_servers.tinyposter]
  url = "https://tinyposter.app/api/mcp"
  http_headers = { Authorization = "Bearer tp_PASTE_YOUR_TOKEN_HERE" }
- Cursor, Continue, Cline, Zed, or another MCP client: add the same remote HTTP MCP server URL and Authorization header to that client's MCP settings.
- Stdio-only clients: wrap the HTTP endpoint with "npx -y mcp-remote https://tinyposter.app/api/mcp" and pass the same Authorization header.

Rules:
- Do not commit this token or write it into any git-tracked file.
- Do not print the token back to me. Mask it in status messages and logs.
- After setup, verify the server is listed or connected.
- If this current session cannot see newly-added MCP servers until restart, tell me exactly what to reopen.

When it is connected, test it by asking Tinyposter to list my connected social accounts.

Replace tp_PASTE_YOUR_TOKEN_HERE with your token first, or use the install link above to bake it in for you. If Claude Code says the current session cannot see new MCP servers yet, quit and reopen it, then run /mcp to confirm tinyposter shows up in the list.

D. Claude Cowork

Cowork is Anthropic's collaborative workspace product. Add tinyposter once at the workspace level and each member signs in with their own tinyposter account. Uses OAuth, no token to copy.

→ Install for me (30 seconds)

1. 01

   Open workspace connectors

   In Cowork, open the workspace settings → Connectors (sometimes labeled MCP servers) → Add MCP server (or Add custom connector).

2. 02

   Paste the URL, that's it

   • Name: tinyposter
   • URL: https://tinyposter.app/api/mcp
   • Advanced settings: leave blank.

   Click Add. The connector is live for the workspace.

3. 03

   Each member signs in once

   The first time anyone in the workspace asks Claude to use tinyposter, Claude pops up a tinyposter Allow screen for that person. They sign into their own tinyposter account and click Allow. Claude remembers it.

Step 3, Try it

In any of the four 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

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