Manage Substack publishing, subscribers, analytics, reader feeds, comments, and images through MCP.
Connect Runs on your machine
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 [email protected]
{
"mcpServers": {
"substack-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"SUBSTACK_PUBLICATION_URL": "<SUBSTACK_PUBLICATION_URL>",
"SUBSTACK_SESSION_TOKEN": "<SUBSTACK_SESSION_TOKEN>",
"SUBSTACK_USER_ID": "<SUBSTACK_USER_ID>"
}
}
}
}
{
"mcpServers": {
"substack-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"SUBSTACK_PUBLICATION_URL": "<SUBSTACK_PUBLICATION_URL>",
"SUBSTACK_SESSION_TOKEN": "<SUBSTACK_SESSION_TOKEN>",
"SUBSTACK_USER_ID": "<SUBSTACK_USER_ID>"
}
}
}
}
{
"servers": {
"substack-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"SUBSTACK_PUBLICATION_URL": "<SUBSTACK_PUBLICATION_URL>",
"SUBSTACK_SESSION_TOKEN": "<SUBSTACK_SESSION_TOKEN>",
"SUBSTACK_USER_ID": "<SUBSTACK_USER_ID>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
SUBSTACK_PUBLICATION_URLRequired | Full URL of your Substack publication, including https:// |
SUBSTACK_SESSION_TOKENRequired, secret | Value of the substack.sid or connect.sid cookie from your authenticated Substack session |
SUBSTACK_USER_IDRequired | Numeric user ID returned by Substack's publication_user request |
Details
| Package | [email protected] (NPM, stdio) |
| Package | docker.io/marcomoauro/substack-mcp:v1.3.2 (OCI, stdio) |
| First published | 3 Sep 2026 |
| Last updated | 3 Sep 2026 |
| Registry name | io.github.marcomoauro/substack-mcp |
More data and analytics servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
