Substack MCP Server and API by Cotlet
Draft, schedule and publish Substack posts and Notes, and read subscriber stats
- Pricing
- Free trial
- Platforms
- Web, API, CLI
- Runs
- Locally or Remotely
- Version
- 1.0.4
- Listing updated
- 2 days ago
About Substack MCP Server and API by Cotlet
Substack MCP Server and API by Cotlet is an MCP server for marketing and seo. It can run locally on your machine or as a hosted remote server.
Substack's own MCP server is read-only and, per the page, requires being an admin of a Bestseller publication. This one covers the writing side with 50 tools that read and write, so an assistant can turn a Markdown file into a draft, schedule the weekly issue, post a Note linking to it, answer comments you missed and report subscribers, revenue and traffic. Posts, Notes and replies wait for your approval before they go out.
It runs in your own Substack session inside a hosted Cloud Browser that you sign in to once, and Cotlet says your password never reaches it. The README lists areas covered as posts and drafts, publishing and scheduling, Notes, comments, subscribers, stats, recommendations and direct messages. If you already use Substack's connector for stats, the page suggests keeping it and adding this one under another name.
A free Python version is also published, installable from PyPI and run on your own machine against your Chrome session. It is unofficial and not affiliated with Substack.
Install
Run in a terminal
claude mcp add --transport http substack https://cotlet.dev/mcp/v1/substack/connectAdd to Settings → Connectors → Add custom connector
https://cotlet.dev/mcp/v1/substack/connectAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"substack": {
"url": "https://cotlet.dev/mcp/v1/substack/connect"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"substack": {
"type": "http",
"url": "https://cotlet.dev/mcp/v1/substack/connect"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"substack": {
"serverUrl": "https://cotlet.dev/mcp/v1/substack/connect"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"substack": {
"type": "http",
"url": "https://cotlet.dev/mcp/v1/substack/connect"
}
}
}Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- list_posts
- List posts, for example drafts
What it does
- Markdown to draft
- Creates a post draft from Markdown text.
- Scheduling and publishing
- Schedules or publishes a post, with your approval.
- Notes
- Posts Notes, such as a link card for a new issue.
- Comment replies
- Finds unanswered comments and drafts replies.
- Subscriber and revenue reports
- Reports new and paid subscribers, cancellations, revenue, opens and traffic sources.
- Subscriber management
- Tags and adds subscribers.
Good for
- Schedule a weekly newsletter issue from a Markdown file
- Post a Note after each new article
- Answer reader comments in a batch
- Pull last week's growth numbers
- Tag subscribers by segment
Pricing
Free trial
Hosted by Cotlet: 7-day trial with 2,000 credits, no card; then credit packs from $29 one time
Prices change. Check cotlet.dev before you buy.
Substack MCP Server and API by Cotlet FAQ
How is this different from Substack's official MCP?
Per the page, the official one is read-only and limited to Bestseller publications; this one also writes drafts, Notes and replies.
How many tools does it have?
50, covering posts, Notes, comments, subscribers, stats, recommendations and direct messages.
Can I self-host it?
Yes. substack-api-mcp is on PyPI and runs locally with your Chrome session.
Is my password shared?
No. The page says it never reaches Cotlet.
Is Substack MCP Server and API by Cotlet free?
Substack MCP Server and API by Cotlet is a paid product with a free trial.
How do I add Substack MCP Server and API by Cotlet to Claude Code?
Run this command in your terminal: claude mcp add --transport http substack https://cotlet.dev/mcp/v1/substack/connect
What are the best alternatives to Substack MCP Server and API by Cotlet?
The closest alternatives to Substack MCP Server and API by Cotlet are Google Ads + Meta Ads + SEO/GEO MCP, Calven, MCP, Red Center Studio free tools and PostBaton.
Alternatives to Substack MCP Server and API by Cotlet

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat
- 8 tools
- Remote
- Freemium
- 8.1K GitHub stars
- Marketing and SEO

Calven
MCP serverProduct marketing context from Calven delivered into Claude, ChatGPT and other AI tools
Not checked yet- Remote
- Free trial
- 3 GitHub stars
- Marketing and SEO

MCP
MCP serverMCP server for planning, scheduling and measuring social and ad campaigns with approvals
- Remote
- Freemium
- Marketing and SEO

Red Center Studio free tools
MCP serverFree website checks for AI readiness, DNS dependencies, domain health and Bubble errors
- 5 tools
- Remote
- Free
- Marketing and SEO

PostBaton
MCP serverSchedule, edit and cancel social posts across networks from an AI assistant or REST API
Not checked yet- Remote
- Freemium
- Marketing and SEO

ASOScan
MCP serverASO data for your own iOS and Android apps: rankings, keywords, reviews, scores
- Remote
- Free trial
- Marketing and SEO