What is Substack Mcp

substack-mcp is a Model Context Protocol (MCP) Server designed for Substack, allowing LLM clients to interact with Substack’s API for various automation tasks such as creating posts and managing drafts.

Use cases

Use cases for substack-mcp include automating the creation of draft posts for blogs, managing content drafts efficiently, and integrating Substack functionalities into other applications or workflows.

How to use

To use substack-mcp, you need to configure your MCP client with Substack tokens (session token, publication URL, user ID) and add the substack-mcp command to your MCP configuration JSON file. You can install it using NPX or Docker.

Key features

Key features of substack-mcp include the ability to create draft posts with specified titles, subtitles, and body content, as well as integration with various LLM clients that support MCP.

Where to use

substack-mcp can be used in content creation and management fields, particularly for writers and publishers using Substack to automate their posting processes.

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

📋 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

This option requires Node.js to be installed on your system.

1. 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>"
      }
    }
  }
}

2. Replace <SUBSTACK_PUBLICATION_URL>, <YOUR_SESSION_TOKEN> and <YOUR_USER_ID> with your credentials.

This option requires Docker to be installed on your system.

1. 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>"
      }
    }
  }
}

2. 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.

🆘 Support

• For issues with this MCP Server: Open an issue on GitHub