Substack MCP Server MCP Server

Name: Substack MCP Server MCP Server
Author: io.github.conorbronsdon

io.github.conorbronsdon/substack-mcp

Repository Registry

What is the Substack MCP Server MCP server?

Substack MCP server: posts are draft-only by design; short-form Notes publish immediately.

How to install Substack MCP Server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

SUBSTACK_PUBLICATION_URL
required
Your Substack publication URL (e.g., https://yourblog.substack.com)
SUBSTACK_SESSION_TOKEN
required
connect.sid cookie value from your Substack session
SUBSTACK_USER_ID
required
Your Substack user ID

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "substack-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@conorbronsdon/substack-mcp"
      ],
      "env": {
        "SUBSTACK_PUBLICATION_URL": "<YOUR_SUBSTACK_PUBLICATION_URL>",
        "SUBSTACK_SESSION_TOKEN": "<YOUR_SUBSTACK_SESSION_TOKEN>",
        "SUBSTACK_USER_ID": "<YOUR_SUBSTACK_USER_ID>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "substack-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@conorbronsdon/substack-mcp"
      ],
      "env": {
        "SUBSTACK_PUBLICATION_URL": "<YOUR_SUBSTACK_PUBLICATION_URL>",
        "SUBSTACK_SESSION_TOKEN": "<YOUR_SUBSTACK_SESSION_TOKEN>",
        "SUBSTACK_USER_ID": "<YOUR_SUBSTACK_USER_ID>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "substack-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@conorbronsdon/substack-mcp"
      ],
      "env": {
        "SUBSTACK_PUBLICATION_URL": "<YOUR_SUBSTACK_PUBLICATION_URL>",
        "SUBSTACK_SESSION_TOKEN": "<YOUR_SUBSTACK_SESSION_TOKEN>",
        "SUBSTACK_USER_ID": "<YOUR_SUBSTACK_USER_ID>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "substack-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@conorbronsdon/substack-mcp"
      ],
      "env": {
        "SUBSTACK_PUBLICATION_URL": "<YOUR_SUBSTACK_PUBLICATION_URL>",
        "SUBSTACK_SESSION_TOKEN": "<YOUR_SUBSTACK_SESSION_TOKEN>",
        "SUBSTACK_USER_ID": "<YOUR_SUBSTACK_USER_ID>"
      }
    }
  }
}

Claude Code

claude mcp add substack-mcp --env SUBSTACK_PUBLICATION_URL=<YOUR_SUBSTACK_PUBLICATION_URL> --env SUBSTACK_SESSION_TOKEN=<YOUR_SUBSTACK_SESSION_TOKEN> --env SUBSTACK_USER_ID=<YOUR_SUBSTACK_USER_ID> -- npx -y @conorbronsdon/substack-mcp