Substack MCP
by Greg-Swiftomatic
The Substack MCP server enables AI assistants like Claude to interact with Substack newsletters, posts, and authors through a standardized interface. It leverages the Substack API library and makes its functionality available through MCP.
Last updated: N/A
What is Substack MCP?
This is a Model Context Protocol (MCP) server that allows AI assistants like Claude to access and interact with Substack data, including newsletters, posts, and author information.
How to use Substack MCP?
First, clone the repository and set up a virtual environment using uv. Install the necessary dependencies, then run the server using python substack_mcp.py. Configure Claude for Desktop by adding the server configuration to the claude_desktop_config.json file. Finally, restart Claude and use example queries to interact with Substack data.
Key features of Substack MCP
Retrieves newsletter posts, podcasts, and recommendations
Gets post content and metadata
Searches for posts within newsletters
Gets user profile information and subscriptions
Provides a standardized interface for AI assistants to interact with Substack
Uses the Substack API library
Use cases of Substack MCP
Allowing Claude to summarize recent posts from a Substack newsletter
Enabling Claude to retrieve the content of a specific Substack post
Using Claude to search for posts within a newsletter based on keywords
Getting author information from a Substack publication
Recommending newsletters based on a Substack publication
FAQ from Substack MCP
How do I check for errors?
How do I check for errors?
Check Claude's logs for errors in the ~/Library/Logs/Claude/mcp*.log (macOS/Linux) or %APPDATA%\Claude\Logs\mcp*.log (Windows) files.
How do I verify the server is running?
How do I verify the server is running?
Run python substack_mcp.py in your terminal and ensure it builds and runs without errors.
What if Claude can't connect to the server?
What if Claude can't connect to the server?
Make sure your claude_desktop_config.json file has the correct paths and syntax. Also, try restarting Claude for Desktop completely.
What is MCP?
What is MCP?
MCP stands for Model Context Protocol, which is Anthropic's protocol for standardized LLM integrations.
What dependencies are required?
What dependencies are required?
Python 3.10 or higher, Claude for Desktop, and the mcp[cli] and substack-api Python packages.