Skip to content
MCP server

Substack MCP Server

Manage Substack publishing, subscribers, analytics, reader feeds, comments, and images…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.3.2
Listing updated
5 days ago

About Substack MCP Server

Substack MCP Server is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Manage Substack publishing, subscribers, analytics, reader feeds, comments, and images through MCP.

Install

Run in a terminal

claude mcp add substack-mcp --env SUBSTACK_PUBLICATION_URL='<SUBSTACK_PUBLICATION_URL>' --env SUBSTACK_SESSION_TOKEN='<SUBSTACK_SESSION_TOKEN>' --env SUBSTACK_USER_ID='<SUBSTACK_USER_ID>' -- npx -y substack-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "substack-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "substack-mcp"
      ],
      "env": {
        "SUBSTACK_PUBLICATION_URL": "<SUBSTACK_PUBLICATION_URL>",
        "SUBSTACK_SESSION_TOKEN": "<SUBSTACK_SESSION_TOKEN>",
        "SUBSTACK_USER_ID": "<SUBSTACK_USER_ID>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "substack-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "substack-mcp"
      ],
      "env": {
        "SUBSTACK_PUBLICATION_URL": "<SUBSTACK_PUBLICATION_URL>",
        "SUBSTACK_SESSION_TOKEN": "<SUBSTACK_SESSION_TOKEN>",
        "SUBSTACK_USER_ID": "<SUBSTACK_USER_ID>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "substack-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "substack-mcp"
      ],
      "env": {
        "SUBSTACK_PUBLICATION_URL": "<SUBSTACK_PUBLICATION_URL>",
        "SUBSTACK_SESSION_TOKEN": "<SUBSTACK_SESSION_TOKEN>",
        "SUBSTACK_USER_ID": "<SUBSTACK_USER_ID>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "substack-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "substack-mcp"
      ],
      "env": {
        "SUBSTACK_PUBLICATION_URL": "<SUBSTACK_PUBLICATION_URL>",
        "SUBSTACK_SESSION_TOKEN": "<SUBSTACK_SESSION_TOKEN>",
        "SUBSTACK_USER_ID": "<SUBSTACK_USER_ID>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "substack-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "substack-mcp"
      ],
      "env": {
        "SUBSTACK_PUBLICATION_URL": "<SUBSTACK_PUBLICATION_URL>",
        "SUBSTACK_SESSION_TOKEN": "<SUBSTACK_SESSION_TOKEN>",
        "SUBSTACK_USER_ID": "<SUBSTACK_USER_ID>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • SUBSTACK_PUBLICATION_URLFull URL of your Substack publication, including https://Required
  • SUBSTACK_SESSION_TOKENValue of the substack.sid or connect.sid cookie from your authenticated Substack sessionRequired
  • SUBSTACK_USER_IDNumeric user ID returned by Substack's publication_user requestRequired
  • SUBSTACK_PUBLICATION_URLFull URL of your Substack publication, including https://Required
  • SUBSTACK_SESSION_TOKENValue of the substack.sid or connect.sid cookie from your authenticated Substack sessionRequired
  • SUBSTACK_USER_IDNumeric user ID returned by Substack's publication_user requestRequired

Pricing

Open source

Prices change. Check implementing.substack.com before you buy.

Substack MCP Server FAQ

Is Substack MCP Server free?

Yes. Substack MCP Server is open source, so you can use and self-host it for free.

How do I add Substack MCP Server to Claude Code?

Run this command in your terminal: claude mcp add substack-mcp --env SUBSTACK_PUBLICATION_URL='<SUBSTACK_PUBLICATION_URL>' --env SUBSTACK_SESSION_TOKEN='<SUBSTACK_SESSION_TOKEN>' --env SUBSTACK_USER_ID='<SUBSTACK_USER_ID>' -- npx -y substack-mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers