Claude

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.

Skip the reading?

Pick your Claude and we'll do the boring parts (make a token, fill in the snippet, open the right settings page) for you in about 30 seconds:

→ Claude Desktop · → Claude.ai (web) · → Claude Code · → Claude Cowork

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

Skip this if you're on Claude.ai or Cowork
Claude.ai (web) and Claude Cowork connect using OAuth — you log into tinyposter through a popup, no token to copy. Skip straight to Section B or D below. You only need a token for Claude Desktop or Claude Code.

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.
Keep this private
Anyone with this token can post for you. If it leaks, just go revoke it on the same page.

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 DeveloperEdit 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
    {
      "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) → SettingsConnectors. 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 the Claude Code CLI, one command:

→ Install for me (30 seconds)

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

Each member needs a tinyposter account
Cowork doesn't share one tinyposter connection across the team. Every workspace member who wants to post needs their own tinyposter account and posts to their own connected social accounts. If a teammate isn't signed up yet, they'll see the tinyposter login screen during the Allow step.

Step 3 — Try it

In any of the four Claude options above, ask:

text
What social accounts am I connected to on tinyposter?

If it lists your platforms, it works. Now try a real post:

text
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"

Claude Desktop or Code: your token is wrong or expired. Go to your tokens page, make a fresh one, and update the config.

Claude.ai or Cowork: the OAuth connection got revoked or expired. In Claude, remove the tinyposter connector and add it again — you'll see the Allow screen on tinyposter once more.

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.

Claude.ai pops up the tinyposter login screen instead of Allow

You're not signed into tinyposter in this browser yet. Sign in once at tinyposter.app/dashboard, then go back to Claude and add the connector again. The Allow screen will appear instead.

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