Substack MCP Server logo

Substack MCP Server

by Greg-Swiftomatic

The Substack MCP Server enables Claude and other AI assistants to interact with Substack newsletters, posts, and user profiles. It converts the Substack API library into an Anthropic MCP server.

View on GitHub

Last updated: N/A

What is Substack MCP Server?

This is a Model Context Protocol (MCP) server that allows Claude and other AI assistants to interact with Substack newsletters. It leverages the Substack API to retrieve posts, user profiles, and other information.

How to use Substack MCP Server?

First, clone the repository and install the dependencies. Then, configure Claude for Desktop to connect to the server by adding the server configuration to the claude_desktop_config.json file. Finally, run the server and use Claude to query Substack data.

Key features of Substack MCP Server

  • Retrieve newsletter posts, podcasts, and recommendations

  • Get user profile information and subscriptions

  • Fetch post content and metadata

  • Search for posts within newsletters

  • Search across multiple Substack newsletters simultaneously

  • Discover popular Substack newsletters by category

Use cases of Substack MCP Server

  • Researching topics across multiple Substack newsletters

  • Discovering new newsletters based on categories of interest

  • Analyzing content from specific Substack authors

  • Integrating Substack data into AI workflows

FAQ from Substack MCP Server

How do I install the server?

Clone the repository, set up a virtual environment, and install the dependencies using pip install -r requirements.txt or uv pip install -r requirements.txt.

How do I connect the server to Claude?

Add the server configuration to the claude_desktop_config.json file in your Claude for Desktop application.

What kind of queries can I make to Claude?

You can ask Claude to show recent posts, get post content, search for topics, discover popular newsletters, and retrieve author information.

What are the available tools provided by the server?

The server provides tools like get_newsletter_posts, get_post_content, search_newsletter, search_across_substacks, discover_popular_substacks, get_author_info, get_newsletter_recommendations, and get_newsletter_authors.

How do I troubleshoot issues with the server?

Check Claude's logs, ensure the server runs without errors, and verify the configuration file paths in Claude for Desktop.