Skip to main content

Typefully MCP Server

Updated over 2 weeks ago

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.

What You Can Do

Create & Schedule Content

  • Write posts for Twitter/X, LinkedIn, Threads, Bluesky, and Mastodon

  • Schedule posts for specific dates and times

  • Add posts to your queue

  • Create threads and multi-platform posts

Manage Your Drafts

  • View all your drafts

  • Edit existing drafts

  • Delete drafts you no longer need

  • Filter drafts by status or platform

View Your Queue & Published Posts

  • See what's scheduled to go out

  • Review recently published posts

  • Check your posting schedule

Account & Connected platforms

  • View your connected social accounts

  • Get account information

Media & Organization

  • Upload images and media for your posts

  • Organize content with tags

  • Create new tags for better organization

Setup Guides

Claude

Requirements: Claude Pro or Max plan

Go to Integrations → Claude in Typefully and follow instructions for adding a custom connector to your Claude account.

ChatGPT

Requirements: ChatGPT Pro or Plus account

Go to Integrations → ChatGPT in Typefully and follow instructions for adding a custom connector to your ChatGPT account.

Connecting to any AI assistant

Go to Integrations → MCP in Typefully and get and MCP URL for your connector.

Claude Code (CLI)

Add Typefully to Claude Code using the command line:

claude mcp add typefully --transport http --url "SERVER_URL"

Replace SERVER_URL with the URL from your Typefully settings: Integrations → 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

Verify Installation: Run the /mcp command to see connection status.

Cursor

Step 1: Open MCP Settings

  • Go to FilePreferencesCursor SettingsMCP

  • 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": "SERVER_URL"
}
}
}

Replace SERVER_URL with the URL from your Typefully settings: Integrations → MCP.

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

MCP Endpoint

POST /mcp?TYPEFULLY_API_KEY=YOUR_KEY

Health Check

GET /health

Troubleshooting

"API key not set" or authentication errors

  • Verify your API key is correctly entered in the configuration

  • Check for extra spaces or missing characters

  • Try regenerating your API key in Typefully settings

Connection issues

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:

Did this answer your question?