Substack MCP Server
Enables AI agents to work inside a signed-in Substack account: publish and schedule Markdown newsletter posts, schedule and publish Notes, manage subscribers, read publication stats (subscriber growth and revenue), and list post comments to draft replies without sending.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Substack MCP server for ChatGPT and Claude
Yes, ChatGPT, Claude and other AI agents can work in your Substack account. Use Cotlet.dev to publish posts, schedule Notes, manage subscribers and read publication stats in your signed-in account.
What you can ask
Schedule a Markdown newsletter draft for Friday at 9:00 AM.
Publish a Note tomorrow at 10:00 AM with this text and ask before saving.
Show subscriber growth and revenue for the last 30 days.
List comments on my latest post and draft replies without sending them.
Create a weekly report of posts, Notes and subscriber changes.
Related MCP server: Substack MCP Server
Connect in 2 minutes
Get your API key at https://cotlet.dev/app and export it as COTLET_API_KEY.
Claude Code
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"ChatGPT
Settings → Apps → add connector URL https://cotlet.dev/mcp/v1, then sign in with Cotlet.dev. No API key needed.
Cursor
Copy .cursor/mcp.json from this repo into your project:
{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": {
"Authorization": "Bearer ${COTLET_API_KEY}"
}
}
}
}Run it locally (stdio)
This repo is a real MCP server. It speaks MCP over stdio, lists its Substack tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.
{"mcpServers":{"substack":{"command":"uvx","args":["substack-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}Or with Docker:
docker build -t substack-mcp .
docker run -i --rm -e COTLET_API_KEY substack-mcpTools: substack_guide, substack_status, substack_open, substack_read, substack_click, substack_type, substack_close. Without COTLET_API_KEY a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".
Command line
Python 3.10+, nothing else to install. From PyPI:
pip install substack-mcp # or run it once: uvx substack-mcp connect
substack-mcp connectOr straight from this repo:
export COTLET_API_KEY="your-key"
python3 substack_agent.py connect # ready config for Claude Code, Cursor, ChatGPT
python3 substack_agent.py status # is Substack ready in your Cotlet.dev account
python3 substack_agent.py guide # Substack screens and sign-in link
python3 substack_agent.py read # open Substack, read the page, close the browser
python3 substack_agent.py tools # list Cotlet.dev tools
python3 substack_agent.py serve # start the stdio MCP server (same as no argument)Questions from Substack users
How do I connect Substack to ChatGPT or Claude?
Sign up at cotlet.dev, log in to Substack once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your Substack account through Cotlet, in their phone apps too.
What can ChatGPT do in Substack?
With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in Substack: schedule newsletter posts from a Markdown draft; post a Note when a new post goes out; weekly subscriber growth and revenue report. You ask in plain words, and anything that reaches other people waits for your OK first.
Can it schedule Notes as well as posts?
Yes. publish_note takes a publish_at time and the Note waits in your scheduled Notes until then. Substack added Notes scheduling in its apps; see On Substack, linked in the sources.
Is the MCP server different from the REST API?
Only the way in. Both have the same 50 tools, inputs and answers, one API key and one price.
Find it on
Request access: https://cotlet.dev/signup?app=substack&utm_source=github&utm_medium=readme&utm_campaign=substack
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Substack MCP server for ChatGPT, Claude and any AI agent: create post, schedule post, publish Note, reply to Notes, send direct message, moderate comments, list subscribers and get post stats in your own Substack account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Substack yourself; Cotlet does not store your password and you need no Substack API key. About the official Substack API: Substack has only a limited API (checked 11 Oct 2026). Its Developer API looks up public creator profiles after approval, and there is no public API to write posts or Notes, manage subscribers or send email. Setup and FAQ: https://cotlet.dev/integrations/substack-api-mcp-server
Let AI agents use your real, signed-in Chrome: tabs, clicks, forms, screenshots and video.
Let your AI agent read and act on your Mail, Calendar, Contacts and more. Works with iCloud.
Let AI agents work in your own signed-in Chrome, with approvals and verified results.
Related MCP Servers
- AlicenseBqualityNot gradedmaintenanceEnables interaction with Substack publications through natural conversation, allowing users to create posts with cover images, publish notes, manage content, and retrieve profile information.82 npm-
- AlicenseAqualityDmaintenanceEnables AI tools to programmatically manage Substack content, including creating drafts, publishing posts, and posting to Substack Notes. It supports image uploads, live blogging, and document formatting compatible with Substack's ProseMirror editor.119MIT
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to draft, publish, and schedule posts on Substack, bypassing the lack of an official publishing API.134-
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to search and read Substack newsletter feeds, stage and publish drafts, interact with community comments, and track subscriber and post analytics through local tools and a web dashboard.1MIT