Skip to main content
Glama
README.md
# MCP Substack Server

A Model Context Protocol (MCP) server for downloading and parsing Substack posts. Works with Claude.ai desktop app.

## Installation

1. Install dependencies:
```bash
npm install
```

2. Configure Claude desktop app:
   
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
  "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"
        }
      }
    }
  }
}
```

3. Start the server:
```bash
npm start
```

## Usage

In Claude desktop app, use:
```
Could you download and summarize this Substack post: [URL]
```

## Features

- Downloads and parses Substack posts
- Extracts title, author, subtitle, and content
- Works with public Substack posts
- Integrates with Claude.ai desktop app

## Requirements

- Node.js v18+
- Claude desktop app

## License

MIT

TDQS

B3.1/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is clearly defined and distinct by default.

Naming Consistency5/5

A single tool inherently has perfect naming consistency, as there are no other tools to compare it against for patterns or conventions.

Tool Count2/5

One tool is too few for a server named 'MCP Substack Server', which implies broader Substack functionality. It feels thin and under-scoped, lacking operations like listing posts, subscribing, or managing content beyond downloading.

Completeness2/5

The tool surface is severely incomplete for a Substack domain. It only supports downloading posts, missing core operations such as creating, updating, deleting posts, or interacting with subscribers, comments, or analytics.

Maintenance

ActivityInactive
ResponsivenessNo issues