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
- Request access.
- Sign in to Substack in your Cotlet.dev Cloud Browser and enable it for agents.
- Add the hosted MCP connection. ChatGPT and Claude use
https://cotlet.dev/mcp/v1/connectwith Cotlet sign-in. Editors can usehttps://cotlet.dev/mcp/v1/substackwith a Cotlet API key.
For Claude Code:
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.
pip install substack-mcp
substack-mcp
For a client that starts local stdio servers:
{"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.
Metadata
Release files for substack-mcp 1.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| substack_mcp-1.1.0.tar.gz | 7.8 kB | Without provenance | Details for substack_mcp-1.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| substack_mcp-1.1.0-py3-none-any.whl | Python 3 | none | any | Details for substack_mcp-1.1.0-py3-none-any.whl |
Total release size: 15.5 kB
Release files / substack_mcp-1.1.0.tar.gz
| Download URL | substack_mcp-1.1.0.tar.gz |
|---|---|
| Size | 7.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2d62879aed22c1101a27ce27cc79bd3991fcd8b528cbeae53c81c508f23f688e
|
|
BLAKE2b-256 checksum How to use checksums |
28423cd8228ece3d4aac16305d826e7ffe1665dfb698bc69be3d1e617fdf4552
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / substack_mcp-1.1.0-py3-none-any.whl
| Download URL | substack_mcp-1.1.0-py3-none-any.whl |
|---|---|
| Size | 7.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
75e117ab1f45b2987278c0f6554d9301044736b8fdbcbf15208824a555587fc0
|
|
BLAKE2b-256 checksum How to use checksums |
ca4269fee48aa8d2a6288bc1ba4c2256870fe21ec5883e96f20307c001aa0ac5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for substack-mcp 1.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.