AI Plugin Index
Substack MCP Server
CommunityMCP server by conorbronsdon · updated · ★ 44 · 356 downloads a week
Substack drafts, Notes, analytics and consented subscribers. Long-form posts stay draft-only. Substack MCP Server is a community project by conorbronsdon, not verified by a company domain.
Last commit 3 days ago
MIT: permissive, fine for commercial use
Clear description, published package or server URL, original repository
No risky patterns in the files we checked
What you need
| Setting | Needed | What it is |
|---|---|---|
SUBSTACK_PUBLICATION_URLEnvironment variable | Required | Your Substack publication URL (e.g., https://yourblog.substack.com) |
SUBSTACK_SESSION_TOKENEnvironment variable, secret | Required | connect.sid cookie value from your Substack session |
SUBSTACK_USER_IDEnvironment variable | Required | Your Substack user ID |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Install Substack MCP Server
Built from the published package, never by AIclaude mcp add substack-mcp-server -e SUBSTACK_PUBLICATION_URL=https://yourblog.substack.com -e SUBSTACK_SESSION_TOKEN=YOUR_SUBSTACK_SESSION_TOKEN -e SUBSTACK_USER_ID=12345 -- npx -y @conorbronsdon/substack-mcpRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"substack-mcp-server": {
"command": "npx",
"args": [
"-y",
"@conorbronsdon/substack-mcp"
],
"env": {
"SUBSTACK_PUBLICATION_URL": "https://yourblog.substack.com",
"SUBSTACK_SESSION_TOKEN": "YOUR_SUBSTACK_SESSION_TOKEN",
"SUBSTACK_USER_ID": "12345"
}
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"substack-mcp-server": {
"command": "npx",
"args": [
"-y",
"@conorbronsdon/substack-mcp"
],
"env": {
"SUBSTACK_PUBLICATION_URL": "https://yourblog.substack.com",
"SUBSTACK_SESSION_TOKEN": "YOUR_SUBSTACK_SESSION_TOKEN",
"SUBSTACK_USER_ID": "12345"
}
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"substack-mcp-server": {
"command": "npx",
"args": [
"-y",
"@conorbronsdon/substack-mcp"
],
"env": {
"SUBSTACK_PUBLICATION_URL": "https://yourblog.substack.com",
"SUBSTACK_SESSION_TOKEN": "YOUR_SUBSTACK_SESSION_TOKEN",
"SUBSTACK_USER_ID": "12345"
}
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add substack-mcp-server --env SUBSTACK_PUBLICATION_URL=https://yourblog.substack.com --env SUBSTACK_SESSION_TOKEN=YOUR_SUBSTACK_SESSION_TOKEN --env SUBSTACK_USER_ID=12345 -- npx -y @conorbronsdon/substack-mcp{
"mcpServers": {
"substack-mcp-server": {
"command": "npx",
"args": [
"-y",
"@conorbronsdon/substack-mcp"
],
"env": {
"SUBSTACK_PUBLICATION_URL": "https://yourblog.substack.com",
"SUBSTACK_SESSION_TOKEN": "YOUR_SUBSTACK_SESSION_TOKEN",
"SUBSTACK_USER_ID": "12345"
}
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
Step-by-step: install Substack MCP Server in Antigravity CLI
gemini mcp add substack-mcp-server npx -y @conorbronsdon/substack-mcpGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the substack-mcp-server block.
Security check
ANo download-and-run commands, hidden instructions or signs of sending keys out were found.
Checked automatically: README.md, package.json. This looks for known risky patterns and is not a full audit. How grades work
Alternatives to Substack MCP Server
All alternatives →
The Power BI Authoring MCP server lets an AI agent create and change Power BI semantic models.
Agent-Native Amplitude/Mixpanel - connect data sources, prompt for charts
Google Ads, Meta Ads, Google Analytics (GA4) & Search Console MCP server by Ryze AI
Create and edit Excel files with AI: charts, PivotTables, formulas. No Excel needed.
MCP gateway for AI models (OpenAI, Grok, DeepSeek, Claude and other function-calling LLMs) and for web pages and apps: one authenticated, observable endpoint in front of your MCP servers with routing, scopes, rate limits and metrics.
MCP server for AI-assisted Deepnote notebook creation and manipulation
Substack MCP Server: common questions
How do I install Substack MCP Server?
In Claude Code run claude mcp add substack-mcp-server -e SUBSTACK_PUBLICATION_URL=https://yourblog.substack.com -e SUBSTACK_SESSION_TOKEN=YOUR_SUBSTACK_SESSION_TOKEN -e SUBSTACK_USER_ID=12345 -- npx -y @conorbronsdon/substack-mcp. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is Substack MCP Server the official server?
Substack MCP Server is a community project by conorbronsdon, not verified by a company domain.
Is Substack MCP Server free?
The code is published under the MIT licence. The service it connects to may have its own pricing.
Is Substack MCP Server safe to use?
It scores 78 of 100. Grades: maintenance A, licence A, quality C. Security check: grade A, no risky patterns found in the files checked. Review the code before you install. How grades work.
What are alternatives to Substack MCP Server?
Similar MCP servers: Power BI Authoring MCP Server (Local), Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Excel MCP Server.
Does Substack MCP Server work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.