Connect your favorite AI assistant to Typefully and manage your social media content through natural conversation. Create posts, schedule content, and manage your queue—all without leaving your AI chat.

What is the Typefully MCP Server?

The Model Context Protocol (MCP) is an open standard that allows AI assistants to connect securely to external services. The Typefully MCP server lets AI tools like Claude, ChatGPT, Cursor, and others interact directly with your Typefully account.

Instead of switching between apps, you can simply ask your AI assistant to create a tweet, schedule a LinkedIn post, or check your schedule.

Also check out this page for more options besides the MCP, like connecting Typefully to OpenClaw or Hermes agents.

What You Can Do

With the Typefully MCP integration, you can create, edit, schedule, and manage drafts across Twitter/X, LinkedIn, Threads, Bluesky, and Mastodon — including threads and multi-platform posts. You can also view your queue and published posts, upload images and media, organize content with tags, and check your connected social accounts.

Authentication

The Typefully MCP server authenticates with OAuth. No API key needed.

The server URL is the same for everyone: https://mcp.typefully.com/mcp

Add it to your AI client and pick OAuth if the client asks how to authenticate. Your client opens Typefully in the browser, you approve access, and you're connected.

Setup Guides

Claude

Requirements: Claude Pro or Max plan

Go to Settings → Agents & Integrations → Claude in Typefully and follow the instructions:

Copy the Typefully server URL: https://mcp.typefully.com/mcp
Open Claude's connector settings ("Add custom connector"), paste the URL, and click "Add"
Claude opens Typefully in your browser and asks you to allow access. Approve it and you're connected
Verify by starting a new conversation and asking Claude for your Typefully account details

ChatGPT

Requirements: ChatGPT Pro or Plus account

Go to Settings → Agents & Integrations → ChatGPT in Typefully and follow the instructions:

Copy the Typefully server URL: https://mcp.typefully.com/mcp
Turn on Developer Mode in ChatGPT: open Settings, go to Security and login, and enable Developer mode (custom connectors sit behind it)
Open the connector form, paste the URL, and leave the authentication settings as they are. ChatGPT works out the rest
ChatGPT opens Typefully in your browser and asks you to allow access. Approve it and the connector is ready
Verify by starting a new conversation and asking ChatGPT for your Typefully account details

Notion

Requirements: Notion agents enabled or MCP support in Notion

Go to Settings → Agents & Integrations → Notion Agents in Typefully and follow the instructions:

Copy the Typefully server URL: https://mcp.typefully.com/mcp
In Notion, go to Settings → Connections → MCP Tools and click Add tool. Paste the URL, and pick OAuth if Notion asks how to authenticate
Notion opens Typefully in your browser and asks you to allow access. Approve it and you're connected
Verify by asking a Notion Agent for your Typefully account details

Connecting to any AI assistant

Go to Settings → Agents & Integrations → MCP in Typefully. The server URL is the same for everyone:

https://mcp.typefully.com/mcp

Add Typefully as a remote MCP server using that URL. Typefully uses the Streamable HTTP transport. Pick OAuth if your client asks how to authenticate, then approve the connection when Typefully opens in your browser.

💡 For AI coding agents like Claude Code or Cursor, try Typefully Agent Skills instead. Skills load context dynamically and often work better than MCP.

Claude Code (CLI)

Add Typefully to Claude Code using the command line:

claude mcp add typefully --transport http --url "https://mcp.typefully.com/mcp"

Scope Options:

--scope user — Available in all your projects
--scope project — Shared with your team via .mcp.json
Default (no flag) — Current project only

Authenticate: Run the /mcp command and pick Typefully to finish the OAuth sign-in in your browser. The same command shows connection status.

Cursor

Step 1: Open MCP Settings

Go to File → Preferences → Cursor Settings → MCP
Or press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (Mac) and type "View: Open MCP Settings"

Step 2: Add Configuration

Edit your MCP config file:

Global (all projects): ~/.cursor/mcp.json
Project-specific: .cursor/mcp.json in your project root

Add the following:

{
  "mcpServers": {
    "typefully": {
      "serverUrl": "https://mcp.typefully.com/mcp"
    }
  }
}

Cursor prompts you to sign in. Approve the connection when Typefully opens in your browser.

Verify Installation: Check "Available Tools" on the MCP settings page.

Example Prompts

Once connected, try these prompts with your AI assistant:

What you want to do	Example prompt
Create a tweet	"Create a tweet about the benefits of async work"
Schedule a post	"Schedule this post for tomorrow at 9am"
View drafts	"Show me my drafts"
Check schedule	"What posts do I have scheduled this week?"
Multi-platform post	"Create a LinkedIn post and a tweet from this content"
Delete a draft	"Delete my draft about product updates"
View published posts	"Show me my recently published posts"

Technical Details

For developers and advanced users:

Property	Value
Transport	Streamable HTTP (stateless)
Server URL	`https://mcp.typefully.com/mcp`
MCP Endpoint	`POST /mcp`
Authentication	OAuth (recommended), or `Authorization: Bearer YOUR_API_KEY` for headless clients
Health Check	`GET /health`

Troubleshooting and FAQs

Authentication errors, or asked to sign in repeatedly

Make sure you finished the approval step in the browser. The connection isn't ready until you allow access on the Typefully page that opens
Remove the Typefully connector from your client, add it again, and approve the connection once more
If your client asks which authentication type to use, pick OAuth

Do I need an API key?
No. MCP doesn't need an API key. When your AI app connects, Typefully opens in the browser and you sign in with OAuth. There's nothing to create, copy, or paste.Only two setups still use an API key: headless or scripted MCP clients that send it as an Authorization: Bearer header, and Agent Skills, where the skill walks you through adding one.

Still using an older key-based setup?

URLs in the old format https://mcp.typefully.com/mcp?TYPEFULLY_API_KEY=YOUR_KEY keep working, but we recommend switching to the plain server URL with OAuth. It's simpler and doesn't leave a credential sitting in your client config.

Connection issues

Check server status on this url: https://mcp.typefully.com/health
Verify your internet connection
Ensure your firewall isn't blocking the connection

Tools not appearing

Restart your AI client after making configuration changes
Check for JSON syntax errors in your config file
Verify the server URL is correct

Support

If you have questions the docs don't answer:

Join our Discord community for help and discussion
Use the live chat here on the site, or email us at [email protected].