Typefully MCP Server

A Model Context Protocol (MCP) server for Typefully API integration, built with TypeScript and Node.js. This server allows AI assistants (like Claude) to create and manage Twitter drafts through Typefully.

Features

• Create Drafts: Create single tweets or multi-tweet threads

• Schedule Posts: Schedule tweets for specific times

• Auto Features: Enable auto-retweet and auto-plug

• Retrieve Drafts: Get scheduled and published drafts

• Thread Support: Automatic thread creation using newline separators

Prerequisites

• Node.js 18.x or higher

• A Typefully account with API access

• Typefully API key (get it from Settings > Integrations in Typefully)

Installation

Option 1: NPX (Recommended)

Run directly without installation:

Option 2: Global Installation

Option 3: From Source

1. Clone the repository:

2. Install dependencies:

3. Build the project:

Configuration

Set your Typefully API key as an environment variable:

Or create a .env file:

Usage

Running the Server

Or for development:

Claude Desktop Integration

Add this server to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

Option 1: Using NPX (Recommended):

Option 2: Using Absolute Node Path (For Local Development):

Note: If you get a "spawn node ENOENT" error, Claude Desktop can't find the node command. Use the absolute path to node instead:

First, find your node path: which node

Available Tools

create_draft

Create a new draft on Typefully.

Parameters:

• content (required): The tweet content or thread

• threadify (optional): Auto-split content into tweets

• schedule_date (optional): ISO date string for scheduling

• auto_retweet_enabled (optional): Enable auto-retweet

• auto_plug_enabled (optional): Enable auto-plug

Example:

Thread Example:

Note: After installation via NPX, you can simply tell Claude: "Create a tweet saying 'Hello from Typefully MCP!'" and it will work automatically.

get_scheduled_drafts

Retrieve your recently scheduled drafts.

Example:

get_published_drafts

Retrieve your recently published drafts.

Example:

Thread Creation

To create multi-tweet threads, separate individual tweets with four consecutive newlines (\n\n\n\n) in your content.

Development

Scripts

• npm run build - Build the TypeScript project

• npm run dev - Run in development mode with auto-reload

• npm run lint - Run ESLint

• npm run typecheck - Run TypeScript type checking

Project Structure

API Reference

This server integrates with the Typefully API v1. For more information about the API, visit the official documentation.

Error Handling

The server includes comprehensive error handling for:

• Invalid API keys

• Network failures

• Malformed requests

• API rate limiting

Common Issues

"spawn node ENOENT" Error in Claude Desktop

This error occurs when Claude Desktop can't find the node command because GUI applications don't inherit the same PATH as your terminal.

Solution: Use the absolute path to node in your Claude Desktop configuration:

1. Find your node path: which node

2. Use the full path in your config instead of just "node"

Example:

Contributing

1. Fork the repository

2. Create a feature branch

3. Make your changes

4. Run tests and linting

5. Submit a pull request

License

MIT License - see LICENSE file for details.

Acknowledgments

• Inspired by the Python Typefully MCP Server

• Built with the Model Context Protocol SDK