Skip to main content

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.
  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:

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.

Current integration guide | Source repository | PyPI

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)

Source distribution for substack-mcp 1.1.0
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)

Table of built distributions (wheels) for substack-mcp 1.1.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

1.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page