Substack Reader

Provides access to Substack subscriptions, feeds, and posts via MCP with cookie-based authentication.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kealu-inc-substack-reader-mcp": {
      "command": "python3",
      "args": [
        "\"/path/to/substack-reader/server.py\""
      ],
      "env": {
        "SUBSTACK_USERNAME": "your-substack-username",
        "SUBSTACK_COOKIES_PATH": "\"/path/to/cookies.json\""
      }
    }
  }
}

You can read and surface your Substack subscriptions from Claude Code using a dedicated MCP Server. It connects to Substack with your cookies and username, then exposes actions to list subscriptions, fetch feeds, read posts, and search newsletters, all through a simple MCP interface directly in Claude Code.

How to use

After you’ve set up the Substack MCP Server, you can ask Claude Code to list your subscriptions, fetch your latest feed, retrieve recent posts from a specific Substack, read full posts, or search within a newsletter. Use natural language prompts like: “List my Substack subscriptions”, “Get my subscription feed”, “Get recent posts from The Pragmatic Engineer”, “Read the latest post about system design”, or “Search for ‘microservices’ in Engineering Leadership”.

How to install

{
  "mcpServers": {
    "substack_reader": {
      "command": "python3",
      "args": ["/path/to/substack-reader/server.py"],
      "env": {
        "SUBSTACK_USERNAME": "your-username",
        "SUBSTACK_COOKIES_PATH": "/path/to/cookies.json"
      }
    }
  }
}

Additional sections

Configuration and usage details are provided below to help you get started quickly and securely.

Available tools

list_subscriptions

List all newsletters you subscribe to

get_feed

Get recent posts from all subscriptions

get_recent_posts

Get posts from a specific newsletter

read_post

Read the full content of a post

search_newsletter

Search within a newsletter