Run your entire Substack
from inside Claude.

{
  "mcpServers": {
    "substack": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://substackmcp.genaiunplugged.com",
        "--header",
        "X-BYOK-Substack-Cookie:PASTE_YOUR_SID_HERE",
        "--header",
        "X-BYOK-Substack-Subdomain:PASTE_YOUR_SUBDOMAIN_HERE"
      ]
    }
  }
}

File (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
File (Windows): %APPDATA%\Claude\claude_desktop_config.json  ·  Requires Node.js / npx

{
  "mcpServers": {
    "substack": {
      "type": "http",
      "url": "https://substackmcp.genaiunplugged.com",
      "headers": {
        "X-BYOK-Substack-Cookie": "PASTE_YOUR_SID_HERE",
        "X-BYOK-Substack-Subdomain": "PASTE_YOUR_SUBDOMAIN_HERE"
      }
    }
  }
}

File: ~/.claude/settings.json

Claude Desktop: Save the config, then fully restart the app. As soon as it loads, a browser window opens automatically for authentication.

Claude Cowork: The connector appears automatically after adding the config to Claude Desktop. Open Cowork → find the Substack MCP connector → click Connect. A browser opens.

In both cases: enter the email you use to subscribe to GenAI Unplugged on Substack. We send a magic link. Click it. Done.

Start a new Claude Code session and run /mcp, or just ask Claude to use a Substack tool. Claude Code opens a browser window automatically for OAuth. Enter the email you use to subscribe to GenAI Unplugged on Substack. We send a magic link. Click it. Done.

1. Remove the old config block. Open ~/Library/Application Support/Claude/claude_desktop_config.json, delete the "substack" entry under mcpServers (keep the rest valid), save.
2. Fully quit Claude Desktop with Cmd+Q, not just the window.
3. Clear the auth cache. In Terminal:

rm -rf ~/.mcp-auth

4. Re-add the clean config (Step 2 above), save, reopen Claude Desktop.
5. Enter your GenAI Unplugged subscriber email, the one subscribed, not your Claude-account email.
6. Open the magic link, click "Connect Substack MCP", and it bounces back into Claude.

Still failing? Check logs at ~/Library/Logs/Claude/.

Prereq: Node.js installed so npx works (node -v to check).

1. Remove the old config block. Open %APPDATA%\Claude\claude_desktop_config.json (paste that into the File Explorer address bar), delete the "substack" entry under mcpServers, save.
2. Fully quit Claude Desktop. The [X] only minimizes to the system tray. Right-click the Claude icon in the tray (bottom-right, under the ^ arrow) → Quit, then confirm in Task Manager (Ctrl+Shift+Esc) that no Claude process remains.
3. Clear the auth cache. In PowerShell:

Remove-Item -Recurse -Force "$env:USERPROFILE\.mcp-auth"

Command Prompt: rmdir /s /q "%USERPROFILE%\.mcp-auth"  ·  Note: this is your home folder (C:\Users\<you>\.mcp-auth), not %APPDATA%.

4. Re-add the clean config (Step 2 above), save, reopen Claude Desktop.
5. Enter your GenAI Unplugged subscriber email, the one subscribed, not your Claude-account email.
6. Open the magic link, click "Connect Substack MCP", and it bounces back into Claude.

Still failing? Check logs at %APPDATA%\Claude\logs\ (e.g. mcp-server-substack.log).