Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • Mealie MCP Server
  • Jira MCP Server
  • MCP Server for Intercom
  • MkDocs MCP Search Server
  • Agent Twitter Client MCP
Back to MCP Servers
Substack MCP

Substack MCP

Public
Greg-Swiftomatic/substack-mcp

Enables AI assistants to access and interact with Substack newsletters, posts, authors, and recommendations via the Model Context Protocol, supporting content retrieval, search, and user profile integration.

python
0 tools
May 29, 2025
Updated Jun 4, 2025

Supercharge Your AI with Substack MCP

MCP Server

Unlock the full potential of Substack MCP through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available • No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

Substack MCP

An MCP (Model Context Protocol) server for Substack API integration with Claude and other AI assistants.

Overview

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

  1. Clone this repository:

    git clone https://github.com/Greg-Swiftomatic/substack-mcp.git cd substack-mcp
  2. Set up a virtual environment using uv:

    curl -LsSf https://astral.sh/uv/install.sh | sh # Install uv if not already installed uv init . uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
  3. Install dependencies:

    uv add "mcp[cli]" substack-api

Usage

Running the Server

Run the MCP server:

python substack_mcp.py

Configuring Claude for Desktop

  1. Open Claude for Desktop's configuration file:

    • macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Add your server configuration:

    { "mcpServers": { "substack": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/substack-mcp", "run", "substack_mcp.py" ] } } }
  3. Restart Claude for Desktop.

Example Queries

Once configured, you can ask Claude questions like:

  • "Show me recent posts from https://stratechery.com/"
  • "What's the content of this post: https://stratechery.com/2023/the-ai-unbundling/"
  • "Search for 'AI' on https://stratechery.com/"
  • "Who are the authors of https://stratechery.com/?"

Available Tools

The server provides the following MCP tools:

ToolDescription
get_newsletter_postsRetrieves recent posts from a Substack newsletter
get_post_contentGets the full content of a specific Substack post
search_newsletterSearches for posts within a newsletter
get_author_infoGets information about a Substack author
get_newsletter_recommendationsGets recommended newsletters for a Substack publication
get_newsletter_authorsGets authors of a Substack newsletter

Project Structure

  • substack_mcp.py - The main MCP server implementation
  • examples/ - Example queries and responses
  • docker/ - Docker configuration for containerized deployment

Development

To contribute to this project:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Troubleshooting

If you encounter issues:

  1. Check Claude's logs for errors:

    # macOS/Linux tail -n 20 -f ~/Library/Logs/Claude/mcp*.log # Windows type %APPDATA%\Claude\Logs\mcp*.log
  2. Verify your server builds and runs without errors:

    python substack_mcp.py
  3. Make sure your claude_desktop_config.json file has the correct paths and syntax.

  4. Try restarting Claude for Desktop completely.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

  • Substack API - The underlying library for Substack interactions
  • Model Context Protocol - Anthropic's protocol for standardized LLM integrations
Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • Mealie MCP Server
    Mealie MCP Server

    Enables AI assistants to access and interact with your Mealie recipe database via Model Context Prot...

    Added May 30, 2025
  • Jira MCP Server
    Jira MCP Server

    Enables AI assistants to seamlessly interact with Jira via Model Context Protocol, offering project ...

    Added May 30, 2025
  • MCP Server for Intercom
    MCP Server for Intercom

    Enables AI assistants to access, search, and filter Intercom customer support conversations and tick...

    4 tools
    Added May 30, 2025
  • MkDocs MCP Search Server
    MkDocs MCP Search Server

    Enables Model Context Protocol integration for efficient, version-specific search of MkDocs-powered ...

    Added May 30, 2025
  • Agent Twitter Client MCP
    Agent Twitter Client MCP

    Model Context Protocol server enabling AI models to interact with Twitter through cookie, username/p...

    Added May 30, 2025