Substack MCP Server
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.
🛠 Available Tools
Inputs:
title
(string): Title of the postsubtitle
(string): Subtitle of the postbody
(string): Body of the post
Returns: "OK" if the post was created successfully.
📋 Requirements
- Substack tokens, follow my guide to obtain them:
- Session token
- Publication URL
- User ID
- An LLM client that supports Model Context Protocol (MCP), such as Claude Desktop, Cursors, or GitHub Copilot
- Docker
🔌 Installation
Introduction
The installation process is standardized across all MCP clients. It involves manually adding a configuration object to your client's MCP configuration JSON file.
If you're unsure how to configure an MCP with your client, please refer to your MCP client's official documentation.
🧩 Engines
<summary>Option 1: Using NPX</summary>This option requires Node.js to be installed on your system.
Add the following to your MCP configuration file:
{ "mcpServers": { "substack-api": { "command": "npx", "args": ["-y", "substack-mcp@latest"], "env": { "SUBSTACK_PUBLICATION_URL": "<YOUR_PUBLICATION_URL>", "SUBSTACK_SESSION_TOKEN": "<YOUR_SESSION_TOKEN>", "SUBSTACK_USER_ID": "<YOUR_USER_ID>" } } } }
Replace
<SUBSTACK_PUBLICATION_URL>
,<YOUR_SESSION_TOKEN>
and<YOUR_USER_ID>
with your credentials.
This option requires Docker to be installed on your system.
Add the following to your MCP configuration file:
{ "mcpServers": { "substack-api": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "SUBSTACK_PUBLICATION_URL", "-e", "SUBSTACK_SESSION_TOKEN", "-e", "SUBSTACK_USER_ID", "marcomoauro/substack-mcp:latest" ], "env": { "SUBSTACK_PUBLICATION_URL": "<YOUR_PUBLICATION_URL>", "SUBSTACK_SESSION_TOKEN": "<YOUR_SESSION_TOKEN>", "SUBSTACK_USER_ID": "<YOUR_USER_ID>" } } } }
Replace
<SUBSTACK_PUBLICATION_URL>
,<YOUR_SESSION_TOKEN>
and<YOUR_USER_ID>
with your credentials.
💻 Popular Clients that supports MCPs
For a complete list of MCP clients and their feature support, visit the official MCP clients page.
Client | Description |
---|---|
Claude Desktop | Desktop application for Claude AI |
Cursor | AI-first code editor |
Cline for VS Code | VS Code extension for AI assistance |
GitHub Copilot MCP | VS Code extension for GitHub Copilot MCP integration |
Windsurf | AI-powered code editor and development environment |
🆘 Support
- For issues with this MCP Server: Open an issue on GitHub