LocalFree server, account needed

Substack MCP server

marcomoauro/substack-mcp

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

92 GitHub stars18 forks1,320 npm downloads / month

Install Substack in Claude Code

npm

Claude Code
claude mcp add marcomoauro-substack -e SUBSTACK_PUBLICATION_URL=... -e SUBSTACK_SESSION_TOKEN=... -e SUBSTACK_USER_ID=... -- npx -y substack-mcp
mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)
{
  "mcpServers": {
    "marcomoauro-substack": {
      "command": "npx",
      "args": [
        "-y",
        "substack-mcp"
      ],
      "env": {
        "SUBSTACK_PUBLICATION_URL": "...",
        "SUBSTACK_SESSION_TOKEN": "...",
        "SUBSTACK_USER_ID": "..."
      }
    }
  }
}

Docker

Claude Code
claude mcp add marcomoauro-substack -e SUBSTACK_PUBLICATION_URL=... -e SUBSTACK_SESSION_TOKEN=... -e SUBSTACK_USER_ID=... -- docker run -i --rm -e SUBSTACK_PUBLICATION_URL -e SUBSTACK_SESSION_TOKEN -e SUBSTACK_USER_ID docker.io/marcomoauro/substack-mcp:v1.3.2
mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)
{
  "mcpServers": {
    "marcomoauro-substack": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SUBSTACK_PUBLICATION_URL",
        "-e",
        "SUBSTACK_SESSION_TOKEN",
        "-e",
        "SUBSTACK_USER_ID",
        "docker.io/marcomoauro/substack-mcp:v1.3.2"
      ],
      "env": {
        "SUBSTACK_PUBLICATION_URL": "...",
        "SUBSTACK_SESSION_TOKEN": "...",
        "SUBSTACK_USER_ID": "..."
      }
    }
  }
}

Replace each ... with your own value.

Frequently asked questions

What does the Substack MCP server do?

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

Is the Substack MCP server free?

The server is free, but you will likely need an account. The server itself is free, but it connects to a service that needs an account or API key, which may have paid tiers. Check the provider for current pricing.

Does Substack run locally or remotely?

Local. Runs on your machine (stdio). You install it with npx, uvx, Docker or from source.

How do I add Substack to Claude Code?

Run: claude mcp add marcomoauro-substack -e SUBSTACK_PUBLICATION_URL=... -e SUBSTACK_SESSION_TOKEN=... -e SUBSTACK_USER_ID=... -- npx -y substack-mcp

More multimedia, audio & video MCP servers

View all