Metadata-Version: 2.5
Name: substack-mcp
Version: 1.1.0
Summary: Connect Substack to ChatGPT, Claude, Codex and Claude Code through Cotlet.dev.
Project-URL: Homepage, https://cotlet.dev/integrations/substack-api-mcp-server?utm_source=pypi&utm_medium=package&utm_campaign=substack
Project-URL: Source, https://github.com/cotlet-connect/substack-mcp
Author-email: "Cotlet.dev" <contact@cotlet.dev>
License-Expression: Elastic-2.0
License-File: LICENSE
Keywords: ai agent,chatgpt,claude,cotlet,mcp server,substack,substack api,substack mcp
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# Substack MCP server for ChatGPT and Claude

Connect ChatGPT, Claude, Codex and Claude Code to Substack publishing workflows through Cotlet.dev. Work with posts, drafts, Notes, comments, subscribers and publication reports in your signed-in account.

Unofficial, not affiliated with Substack.

## Connect

1. [Request access](https://cotlet.dev/signup?app=substack).
2. Sign in to Substack in your Cotlet.dev Cloud Browser and enable it for agents.
3. Add the hosted MCP connection. ChatGPT and Claude use `https://cotlet.dev/mcp/v1/connect` with Cotlet sign-in. Editors can use `https://cotlet.dev/mcp/v1/substack` with a Cotlet API key.

For Claude Code:

```bash
claude mcp add --transport http cotlet-substack https://cotlet.dev/mcp/v1/substack --header "Authorization: Bearer $COTLET_API_KEY"
```

## Publishing workflows

The current integration page documents 50 hosted operations across posts, Notes, comments, subscribers, messages and statistics. You can read published, draft and scheduled posts, retrieve post statistics, create drafts from Markdown, schedule newsletter issues, prepare Notes and comment replies, and report subscriber changes and publication revenue.

Operations marked as asking first require confirmation by default; follow the approval settings in your console.

## Run locally

Python 3.10 or newer is required. Set `COTLET_API_KEY` to your Cotlet API key from https://cotlet.dev/app.

```bash
pip install substack-mcp
substack-mcp
```

For a client that starts local stdio servers:

```json
{"mcpServers":{"substack":{"command":"uvx","args":["substack-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}
```

This package exposes seven browser helper tools: `substack_guide`, `substack_status`, `substack_open`, `substack_read`, `substack_click`, `substack_type` and `substack_close`. They forward to the hosted Cotlet service. The seven local helpers are separate from the 50 operations documented on the integration page. Listing local tools needs no key; executing them needs your Cotlet API key and an enabled Substack connection.

`substack-mcp connect` prints connection examples, `substack-mcp guide` retrieves app guidance, and `substack-mcp read` opens, reads and closes the browser session.

[Current integration guide](https://cotlet.dev/integrations/substack-api-mcp-server) | [Source repository](https://github.com/cotlet-connect/substack-mcp) | [PyPI](https://pypi.org/project/substack-mcp/)
