# Substack MCP Server and API by Cotlet

> Substack MCP Server and API by Cotlet is an MCP server for marketing and seo. Draft, schedule and publish Substack posts and Notes, and read subscriber stats. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** Web, API, CLI
- **Website:** https://cotlet.dev/integrations/substack-api-mcp-server
- **Repository:** https://github.com/cotletdev/substack-api-mcp-server
- **MCP Registry name:** dev.cotlet/substack
- **Categories:** marketing and SEO, news and media
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http substack https://cotlet.dev/mcp/v1/substack/connect
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://cotlet.dev/mcp/v1/substack/connect
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "substack": {
      "url": "https://cotlet.dev/mcp/v1/substack/connect"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "substack": {
      "type": "http",
      "url": "https://cotlet.dev/mcp/v1/substack/connect"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "substack": {
      "serverUrl": "https://cotlet.dev/mcp/v1/substack/connect"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "substack": {
      "type": "http",
      "url": "https://cotlet.dev/mcp/v1/substack/connect"
    }
  }
}
```

## Tools

- `list_posts`: List posts, for example drafts

## 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

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [Red Center Studio free tools](https://ai-powered.com/mcp/red-center-studio-free-tools): Red Center Studio free tools is a free MCP server for marketing and seo.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [ASOScan](https://ai-powered.com/mcp/asoscan): ASOScan is an MCP server for marketing and seo.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [Daniels AI Design Studio](https://ai-powered.com/mcp/daniels-ai-design-studio): Daniels AI Design Studio is an MCP server for design and media.

---
Source: https://ai-powered.com/mcp/substack-mcp-server-and-api-by-cotlet
