Substack MCP Plus

The most advanced Substack MCP server available. Create publication-ready posts in minutes with full rich text formatting, manage drafts, schedule posts, and more - all from Claude Desktop or any MCP-compatible client.

📋 Requirements

• Python 3.10 or higher
• Substack account credentials:
  • Email and password (recommended)
  • OR session token and user ID
• An LLM client that supports Model Context Protocol (MCP)
  • This MCP server has been thoroughly tested with Claude Desktop

⚠️ Important Disclaimers

This is an UNOFFICIAL tool with no affiliation to Substack Inc.

• We are not endorsed by or associated with Substack
• This tool uses the unofficial python-substack library
• Substack does not provide a public API; this tool uses reverse-engineered endpoints
• Functionality may break if Substack changes their private API
• Use at your own risk and in accordance with Substack's Terms of Service

→ See all known issues and limitations

🚀 Zero-Config Setup

1. Install the package

npm install -g substack-mcp-plus

2. Authenticate with Substack

substack-mcp-plus-setup

The setup wizard will:

• Open a browser for secure login
• Handle CAPTCHA challenges
• Store encrypted credentials
• Test your connection

3. Configure Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "substack-mcp-plus": {
      "command": "substack-mcp-plus",
      "env": {
        "SUBSTACK_PUBLICATION_URL": "https://yourpublication.substack.com"
      }
    }
  }
}

That's it! Automatic Python detection, virtual environment setup, and dependency installation.

🌟 Why Choose Substack MCP Plus?

See detailed feature comparison →

✨ Seamless Authentication

• Browser-based setup - No API keys or complex configuration
• CAPTCHA support - Handles security challenges automatically
• Secure token storage - Encrypted local storage, no passwords in configs
• Magic link & password auth - Works with any Substack account type

📝 Unmatched Content Creation

• Full rich text support - Headers, bold, italic, lists, code blocks, images
• Multiple formats - Write in Markdown, HTML, or plain text
• Smart formatting - Automatic conversion to Substack's native format
• Paywall markers - Easily separate free and premium content

⚡ Lightning-Fast Publishing

• 30 seconds to draft - "Create a post about X" → Draft ready in Substack
• Instant publishing - "Publish my latest draft" → Live to subscribers
• No context switching - Write, edit, and publish without leaving Claude Desktop
• Bulk operations - Create multiple posts in minutes, not hours
• From idea to published - What used to take 30-60 minutes now takes 2-3 minutes

🎯 12 Powerful Tools

Create, update, publish, duplicate posts and more. The most comprehensive Substack automation toolkit available.

🛠 Available Tools

All 12 tools at a glance:

1. create_formatted_post - Create rich text drafts
2. update_post - Edit existing drafts
3. publish_post - Publish immediately
4. list_drafts - View draft posts

... View full README on GitHub