Substack MCP Server
Manage Substack publishing, subscribers, analytics, reader feeds, comments, and images…
- 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-mcpAdd 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://RequiredSUBSTACK_SESSION_TOKENValue of the substack.sid or connect.sid cookie from your authenticated Substack sessionRequiredSUBSTACK_USER_IDNumeric user ID returned by Substack's publication_user requestRequiredSUBSTACK_PUBLICATION_URLFull URL of your Substack publication, including https://RequiredSUBSTACK_SESSION_TOKENValue of the substack.sid or connect.sid cookie from your authenticated Substack sessionRequiredSUBSTACK_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.