Substack MCP

An MCP (Model Context Protocol) server for Substack API integration with Claude and other AI assistants

Catalog onlyCatalog onlySTDIO

Overview

Substack MCP is a Model Context Protocol (MCP) server designed for integrating the Substack API with AI assistants like Claude, enabling seamless interaction with Substack newsletters, posts, and authors.

To use Substack MCP, clone the repository, set up a virtual environment, install dependencies, and run the MCP server. Configure Claude for Desktop to connect to the MCP server for querying.

Retrieve newsletter posts, podcasts, and recommendations. - Get post content and metadata. - Search for posts within newsletters. - Access user profile information and subscriptions.

Fetching recent posts from a specific Substack newsletter.
Searching for content within newsletters.
Retrieving author information and recommendations for newsletters.

Add to your AI client

Use these steps to connect Substack MCP in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "substack-mcp-greg-swiftomatic": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-substack-mcp-greg-swiftomatic"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "substack-mcp-greg-swiftomatic": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-substack-mcp-greg-swiftomatic"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "substack-mcp-greg-swiftomatic": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-substack-mcp-greg-swiftomatic"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "substack-mcp-greg-swiftomatic": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-substack-mcp-greg-swiftomatic"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "substack-mcp-greg-swiftomatic": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-substack-mcp-greg-swiftomatic"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "substack-mcp-greg-swiftomatic": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-substack-mcp-greg-swiftomatic"
      ]
    }
  }
}

FAQ

What is the purpose of Substack MCP?

It allows AI assistants to interact with Substack content through a standardized protocol.

What are the prerequisites for installation?

You need Python 3.10 or higher and Claude for Desktop for testing.

How can I troubleshoot issues?

Check Claude's logs for errors and ensure your configuration file is set up correctly.

Developer tools