Typefully MCP Server

A Model Context Protocol (MCP) server that provides integration with the Typefully API, allowing AI assistants to create and manage drafts on Typefully.

Features

• Create drafts with full support for:
  • Multi-tweet threads (using 4 newlines as separator)
  • Automatic threadification
  • Scheduling (specific date/time or next free slot)
  • AutoRT and AutoPlug features
  • Share URLs
• Get scheduled drafts with optional filtering
• Get published drafts with optional filtering

Installation

Prerequisites

• Python 3.10 or higher
• A Typefully account with API access
• Your Typefully API key (get it from Settings > Integrations in Typefully)

Install from source

1. Clone this repository:

git clone <repository-url>
cd typefully-mcp-server

2. Create and activate a virtual environment:

python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install the package:

pip install -e .

Configuration

API Key Management

This server supports secure API key storage using macOS Keychain. You have two options:

Option 1: macOS Keychain (Recommended) 🔐

Store your API key securely in the macOS System keychain:

• Service: typefully-mcp-server
• Account: api_key
• Password: Your Typefully API key

For detailed keychain setup instructions, see CURSOR_SETUP.md.

Option 2: Environment Variables

You can set the API key as an environment variable or include it directly in your MCP configuration.

Note: Environment variables take priority over keychain storage for compatibility.

MCP Configuration

For detailed MCP client setup instructions (Cursor, Claude Desktop, etc.), see CURSOR_SETUP.md.

Basic MCP configuration example:

{
  "mcpServers": {
    "typefully": {
      "command": "/path/to/your/typefully-mcp-server/venv/bin/python",
      "args": ["-m", "typefully_mcp_server.server"],
      "cwd": "/path/to/your/typefully-mcp-server"
    }
  }
}

Usage

Once configured, the MCP server provides the following tools:

create_draft

Create a new draft in Typefully.

Parameters:

• content (required): The content of the draft. Use 4 consecutive newlines to split into multiple tweets.
• threadify (optional): Automatically split content into multiple tweets
• share (optional): If true, returned payload will include a share_url
• schedule_date (optional): ISO formatted date (e.g., "2024-01-15T10:30:00Z") or "next-free-slot"
• auto_retweet_enabled (optional): Enable AutoRT for this post
• auto_plug_enabled (optional): Enable AutoPlug for this post

Example:

Create a draft with content "Hello from MCP! This is my first automated tweet." and schedule it for next free slot

get_scheduled_drafts

Get recently scheduled drafts from Typefully.

Parameters:

• content_filter (optional): Filter drafts to only include "tweets" or "threads"

Example:

Get my scheduled drafts that are threads only

get_published_drafts

Get recently published drafts from Typefully.

Parameters:

• content_filter (optional): Filter drafts to only include "tweets" or "threads"

Example:

Show me all my recently published tweets

Testing

A test script is included to verify the server functionality:

# Make sure your virtual environment is activated
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Test the API connectivity (requires API key configured)
python test_read_api.py

Development

Project Structure

typefully-mcp-server/
├── src/
│   └── typefully_mcp_server/
│       ├── __init__.py
│       ├── server.py      # Main MCP server implementation
│       ├── client.py      # Typefully API client
│       ├─

... [View full README on GitHub](https://github.com/pepuscz/typefully-mcp-server#readme)