How do I connect Substack MCP Server to Claude?

Run `claude mcp add substack-mcp -- npx -y substack-mcp@latest` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.

Is Substack MCP Server free?

The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.

What can Substack MCP Server do?

Substack MCP Server documents 25 tools to the agent, including already_tagged, audience, audience_locations. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.

Substack MCP

Unclaimed

by marcomoauro

A Model Context Protocol (MCP) Server for Substack enabling LLM clients to interact with Substack's API for automations like creating posts, managing drafts, and more.

Set up this server

Compare servers My Stack

01 / Choose your client

02 / Before you connect

Authentication is not specified. Check the project instructions before connecting.

Install the runtime required by the project and make it available to your client.

Project instructionsEnvironment variable names (optional)

Use names from the project instructions, separated by commas. Enter names only, never secret values.

03 / Add the configuration

Source: generated from public install instructions

claude mcp add --transport stdio 'substack-mcp' -- 'npx' '-y' 'substack-mcp@latest'

Run in your terminal after replacing any placeholders.

04 / Check it in your client

Open your client’s MCP settings and confirm the server connects and lists its tools. A copied configuration does not confirm a working connection.

automationclaudemcpmcp-servermodel-context-protocolnewsletternodejspublishingsubstacksubstack-mcp

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

25 of 25 tools

Documented tools (25)

From project documentation. A server handshake does not verify each tool’s description or behavior.

already_tagged

re-adding a tag the post already has answers a bare 400 upstream, so it is

audience

(everyone onlypaid onlyfree founding, optional)

audience_locations

how many countries and US states your subscribers span

audience_overlap

other Substacks whose audience overlaps yours — the collaboration shortlist

churn

unsubscribes

conversion

signups subscribes foundingsubscribes annualsubscribes monthlysubscribes freetrials freetopaidupgrades signupswithin1day estimatedvalue

DateTime

ison isafter isonorafter isbefore isonorbefore

default_comment_sort

(bestfirst mostrecentfirst oldestfirst, optional)

delivery

queued sent delivered dropped

from_date

, todate (string, optional): YYYY-MM-DD. Used only by the reports covering a

growth_events

the individual growth events in a window

growth_sources

where new subscribers came from, ranked

network_attribution

what share of subscribers arrived via the Substack network

order_direction

(asc desc, optional): defaults to desc

paid_subscriber_growth

paid growth rate, new subscriptions, expirations

reader

what it subscribes to, what is in its inbox and feed — which is a different host and a

reading

opens openrate clicks clickthroughrate views subscribersfinishedpost

retention

cohort retention — how much of each signup cohort is still subscribed months later

retention_summary

headline retention at 1, 6 and 12 months

social

likes shares restacks engagementrate uniqueengagements

sort_direction

(asc desc, optional): defaults to desc

status

(drafts published scheduled): which list to read

subscriber_notes

recent Notes written by your subscribers

type

(all notes posts, optional): defaults to all

write_comment_permissions

(everyone subscribers onlypaid none, optional): who may comment

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about Substack MCP Server

How do I connect Substack MCP Server to Claude?: Run `claude mcp add substack-mcp -- npx -y substack-mcp@latest` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.
Is Substack MCP Server free?: The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can Substack MCP Server do?: Substack MCP Server documents 25 tools to the agent, including already_tagged, audience, audience_locations. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.