substack -plus

Substack MCP Plus exposes a suite of tools to manage Substack content directly from an MCP client (e.g., Claude Desktop). The server authenticates with Substack via an interactive setup flow and then lets you create, update, publish, and manage drafts and posts using the 12 available tools (create_formatted_post, update_post, publish_post, list_drafts, list_published, get_post_content, duplicate_post, upload_image, preview_draft, get_sections, get_subscriber_count, delete_draft). Once configured, you can issue commands through your MCP client to generate rich text drafts, attach images, preview content, and publish or schedule posts to your publication. The environment variable SUBSTACK_PUBLICATION_URL ties the MCP server to your Substack publication, ensuring all actions target the correct destination. The setup also handles authentication flows and secure credential storage so you don’t need to manage API keys manually.

Prerequisites:

• Node.js and npm (for the MCP server package)
• Python 3.10 or higher (for supporting tooling and environment if needed)
• Access to the internet to install packages

Installation steps:

1. Install the MCP server package globally

   • npm install -g substack-mcp-plus

2. Authenticate and set up Substack access

   • Run the setup command to authenticate and store credentials securely: substack-mcp-plus-setup
   • Follow the on-screen prompts to log in via the browser and complete any CAPTCHA challenges. The setup will securely store credentials and test the connection.

3. Configure your MCP client with the server

   • Add the following to Claude Desktop (or your MCP client of choice): { "mcpServers": { "substack-mcp-plus": { "command": "substack-mcp-plus", "env": { "SUBSTACK_PUBLICATION_URL": "https://yourpublication.substack.com" } } } }

4. Optional: verify installation

   • List drafts or create a test draft using the MCP client to ensure the server communicates correctly with Substack.

Tips and notes:

• The SUBSTACK_PUBLICATION_URL environment variable must point to your Substack publication URL.
• The toolset supports rich text formats (Markdown, HTML, plain text) and paywall markers for premium content.
• If you encounter authentication issues, re-run substack-mcp-plus-setup to refresh tokens and vault entries.
• For security, credentials are stored in encrypted local storage by the setup flow; avoid embedding passwords in config files.
• Ensure your Substack account permissions allow programmatic post creation and draft management.
• If Substack changes its private API, you may need to update or re-authenticate; monitor the project docs for known issues.