substack-mcp
Substack MCP is a Model Context Protocol server designed to enable AI assistants, such as Claude, to interact with Substack content. It facilitates operations like retrieving posts and searching newsletters using the Substack API through a standardized MCP interface.
Substack MCP
This project implements a Model Context Protocol (MCP) server that 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.
With this MCP server, Claude can:
- Retrieve newsletter posts, podcasts, and recommendations
- Get post content and metadata
- Search for posts within newsletters
- Get user profile information and subscriptions
Installation
Prerequisites
- Python 3.10 or higher
- Claude for Desktop (for testing)
Setup
- Clone this repository.
- Set up a virtual environment.
- Install dependencies.
Usage
Running the Server
Run the MCP server and configure Claude for Desktop to interact with it.
Available Tools
The server provides various MCP tools for interacting with Substack newsletters and posts.
Development
To contribute, fork the repository, create a feature branch, commit changes, and open a Pull Request.
Troubleshooting
Guidance is provided for checking logs and verifying server setup.
License
This project is licensed under the MIT License.