Skip to content
MCP server

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/connect

Add to Settings → Connectors → Add custom connector

https://cotlet.dev/mcp/v1/substack/connect
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "substack": {
      "url": "https://cotlet.dev/mcp/v1/substack/connect"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Hosted 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
  2. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  3. MCP

    MCP server

    MCP server for planning, scheduling and measuring social and ad campaigns with approvals

    • Remote
    • Freemium
    • Marketing and SEO
  4. Free website checks for AI readiness, DNS dependencies, domain health and Bubble errors

    • 5 tools
    • Remote
    • Free
    • Marketing and SEO
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. ASOScan

    MCP server

    ASO data for your own iOS and Android apps: rankings, keywords, reviews, scores

    • Remote
    • Free trial
    • Marketing and SEO