home / mcp / mcp substack server

MCP Substack Server

🤖 MCP Server for Substack integration with Claude AI Desktop. Download and parse Substack posts directly in your Claude conversations.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "michalnaka-mcp-substack": {
      "command": "/opt/homebrew/bin/node",
      "args": [
        "/path/to/mcp-substack/lib/index.mjs"
      ]
    }
  }
}

You can run a lightweight MCP server that downloads, parses, and exposes Substack post content so your client can request structured data like title, author, subtitle, and post body. This server integrates with Claude.ai desktop app to automate retrieval and summarization of Substack posts.

How to use

Use your MCP client to direct the server to fetch a Substack post and return its structured data. For example, instruct your client to download and summarize a Substack post by providing the post URL. The server will extract key fields such as the title, author, subtitle, and content, and deliver them in a consistent format for downstream processing or summarization.

How to install

Prerequisites: Make sure you have Node.js v18+ installed and the Claude desktop app set up on your system.

Install dependencies, configure the MCP server in Claude, and start the service using the following steps.

npm install

Configure Claude desktop app to load the MCP server:
```
{
  "mcpServers": {
    "mcp-substack": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/path/to/mcp-substack/lib/index.mjs"],
      "methods": {
        "download_substack": {
          "description": "Download and parse content from a Substack post"
        }
      }
    }
  }
}
```

Start the server:
```
npm start

Additional notes

This MCP server is designed to work with public Substack posts. It provides a dedicated method named download_substack that downloads and parses content from a Substack post, exposing fields such as the title, author, subtitle, and content for downstream use in your workflow.

Prerequisites and environment

Prerequisites include Node.js v18+ and the Claude desktop app. The server configuration is provided as a JSON snippet to be loaded by Claude, which maps a runtime command and arguments to an MCP method for downloading Substack content.

Available tools

download_substack

Download and parse content from a Substack post, returning title, author, subtitle, and content