Substack
📇 ☁️ - MCP server for Substack — read posts, manage drafts, publish Notes, get comments, a
What is Substack?
Substack is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 📇 ☁️ - mcp server for substack — read posts, manage drafts, publish notes, get comments, a
📇 ☁️ - MCP server for Substack — read posts, manage drafts, publish Notes, get comments, a
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP protocol support
Use Cases
Maintainer
Works with
Installation
NPM
npx -y substackManual Installation
npx -y substackConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Substack
The Substack MCP server gives AI assistants programmatic access to Substack publications, enabling them to read existing posts, create and update drafts in Markdown, schedule or publish content, upload images, and manage Notes. It authenticates via your Substack session token and publication URL, making it straightforward to integrate newsletter workflows into AI-driven content pipelines. Writers and publishers who want to draft, edit, or automate publishing of Substack content directly from Claude or other AI tools will find this server especially useful.
Prerequisites
- Python 3.10+ with uv or pip
- A Substack account with an active publication
- Your Substack session token (SUBSTACK_SESSION_TOKEN) from browser cookies
- Your publication URL (SUBSTACK_PUBLICATION_URL, e.g. https://yourname.substack.com)
- An MCP-compatible client such as Claude Desktop or Claude Code
Clone the repository and install dependencies
Clone the substack-mcp repository and install it into a local virtual environment using uv.
git clone https://github.com/nanameru/substack-mcp.git
cd substack-mcp
uv pip install -e .Run the interactive setup to configure credentials
The package provides a setup wizard that stores your publication URL and session token in a config file so you don't have to hardcode them.
substack-mcp-setupObtain your Substack session token
Log in to Substack in your browser, open Developer Tools > Application > Cookies, and copy the value of the substack.sid cookie. This is your SUBSTACK_SESSION_TOKEN.
Register the server with Claude Code
Use the claude mcp add command to register substack-mcp as a user-scoped MCP server pointing to the installed binary.
claude mcp add substack-mcp --scope user -- ~/.venv/bin/substack-mcpOr add manually to Claude Desktop config
Edit claude_desktop_config.json with the correct path to the substack-mcp binary and your environment variables.
{
"mcpServers": {
"substack": {
"command": "/path/to/.venv/bin/substack-mcp",
"env": {
"SUBSTACK_PUBLICATION_URL": "https://yourname.substack.com",
"SUBSTACK_SESSION_TOKEN": "your_session_token"
}
}
}
}Substack Examples
Client configuration
Claude Desktop config using environment variables for Substack credentials.
{
"mcpServers": {
"substack": {
"command": "/path/to/substack-mcp/.venv/bin/substack-mcp",
"env": {
"SUBSTACK_PUBLICATION_URL": "https://yourname.substack.com",
"SUBSTACK_SESSION_TOKEN": "your_substack_session_token"
}
}
}
}Prompts to try
After connecting, use these prompts to manage your Substack publication.
- "List all my current drafts on Substack"
- "Create a new draft titled 'The Future of AI Agents' with this outline as the body"
- "Schedule the draft with ID 12345 to publish on Friday at 9am"
- "Publish draft 12345 and send it to email subscribers"
- "Upload the image at /path/to/cover.png and set it as the cover image for my latest draft"Troubleshooting Substack
Authentication fails — session token rejected
The substack.sid cookie value expires when you log out or after inactivity. Log back in to Substack, copy a fresh cookie value, and update SUBSTACK_SESSION_TOKEN in your config or re-run substack-mcp-setup.
substack-mcp binary not found after installation
Confirm you installed the package with uv pip install -e . inside the project directory. Run which substack-mcp or find ~/.venv -name substack-mcp to locate the installed binary and use that full path in your config.
Drafts are created but publish fails
Publishing requires an active Substack subscription on your account and a properly configured publication. Verify that your account has publishing permissions and that SUBSTACK_PUBLICATION_URL points to your publication, not the Substack home page.
Frequently Asked Questions about Substack
What is Substack?
Substack is a Model Context Protocol (MCP) server that 📇 ☁️ - mcp server for substack — read posts, manage drafts, publish notes, get comments, a It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Substack?
Install via npm with the command: npx -y substack. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Substack?
Substack works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Substack free to use?
Yes, Substack is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Substack Alternatives — Similar Communication Servers
Looking for alternatives to Substack? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Substack in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Substack?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.