mcpbeat Sign in

Substack MCP Server

local only

Substack MCP Server runs on your own machine — the client starts it, so there is no endpoint to ping. 1 561 installs a week from npm. Last commit 1 Nov 2026.

Substack drafts, Notes, analytics and consented subscribers. Long-form posts stay draft-only.

Installs per day peak 332 · avg 90 · +211% w/w
a month agotoday
1 561
Installs / week
npm · @conorbronsdon/substack-mcp
45
Stars
3 open issues
1 Nov 2026
Last commit
9 releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 2 d ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Runs an external command src/auth/keychain.ts:47
  const child = spawn(file, args, { stdio: ["pipe", "pipe", "pipe"], windowsHide: true });

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add substack-mcp -e 'SUBSTACK_PUBLICATION_URL=<SUBSTACK_PUBLICATION_URL>' -e 'SUBSTACK_SESSION_TOKEN=<SUBSTACK_SESSION_TOKEN>' -e 'SUBSTACK_USER_ID=<SUBSTACK_USER_ID>' -- npx -y @conorbronsdon/substack-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "substack-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@conorbronsdon/substack-mcp"
      ],
      "env": {
        "SUBSTACK_PUBLICATION_URL": "<SUBSTACK_PUBLICATION_URL>",
        "SUBSTACK_SESSION_TOKEN": "<SUBSTACK_SESSION_TOKEN>",
        "SUBSTACK_USER_ID": "<SUBSTACK_USER_ID>"
      }
    }
  }
}
~/.codex/config.toml
[mcp_servers.substack-mcp]
command = "npx"
args = ["-y", "@conorbronsdon/substack-mcp"]
env = { SUBSTACK_PUBLICATION_URL = "<SUBSTACK_PUBLICATION_URL>", SUBSTACK_SESSION_TOKEN = "<SUBSTACK_SESSION_TOKEN>", SUBSTACK_USER_ID = "<SUBSTACK_USER_ID>" }
.cursor/mcp.json
{
  "mcpServers": {
    "substack-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@conorbronsdon/substack-mcp"
      ],
      "env": {
        "SUBSTACK_PUBLICATION_URL": "<SUBSTACK_PUBLICATION_URL>",
        "SUBSTACK_SESSION_TOKEN": "<SUBSTACK_SESSION_TOKEN>",
        "SUBSTACK_USER_ID": "<SUBSTACK_USER_ID>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "substack-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@conorbronsdon/substack-mcp"
      ],
      "env": {
        "SUBSTACK_PUBLICATION_URL": "<SUBSTACK_PUBLICATION_URL>",
        "SUBSTACK_SESSION_TOKEN": "<SUBSTACK_SESSION_TOKEN>",
        "SUBSTACK_USER_ID": "<SUBSTACK_USER_ID>"
      }
    }
  }
}

Put your own values in place of <SUBSTACK_PUBLICATION_URL> (Your Substack publication URL (e.g., https://yourblog.substack.com)), <SUBSTACK_SESSION_TOKEN> (connect.sid cookie value from your Substack session), <SUBSTACK_USER_ID> (Your Substack user ID). The author’s registry entry marks them as required.

Alternatives to Substack MCP Server

same job, measured the same way
FastMCP server for Substack — publish Notes and posts, pull analytics, manage dr
by adelaidasofia

FastMCP server for Substack — publish Notes and posts, pull analytics, manage drafts, pluggable…

local only
Substack MCP Server
by marcomoauro

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

238 installs/wk local only
Looply
by xie38388

Looply AI call center MCP Server - manage calls, leads, contacts, and analytics.

27 installs/wk local only
MCP Mailtrap
by pijusz

MCP server for the Mailtrap email platform — analytics, sending, contacts, sandbox

117 installs/wk local only
Opn MCP
by ysalitrynskyi

MCP server for opn.onl: shorten links, analytics, branded QR codes, and link management.

45 installs/wk local only
beehiiv
by beehiiv

Manage beehiiv newsletters, posts, podcasts, community, subscribers, and analytics.

answering
Apple Podcasts MCP Server
by conorbronsdon

Apple Podcasts Connect owner analytics over Reporter: plays, followers, episodes. Read-only.

51 installs/wk local only
PromptEden
by yulanventures

Stdio MCP server for PromptEden projects, monitors, answers, and analytics.

60 installs/wk local only

Substack MCP Server — questions

Answers built from our own checks of this server.

Why is there no uptime for Substack MCP Server?
Substack MCP Server runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package @conorbronsdon/substack-mcp was installed 1 561 times last week.
How do I connect Substack MCP Server?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls @conorbronsdon/substack-mcp straight from npm; nothing to host, nothing to sign up for.
How many people use Substack MCP Server?
The npm package @conorbronsdon/substack-mcp was installed 1 561 times in the last week. Week over week that is +211%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Substack MCP Server open source?
Yes — it is published under the MIT licence, written in TypeScript, 45 stars on GitHub and 3 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.