Substack Notes MCP

Create, schedule, manage, and fetch Substack notes from any AI assistant — Claude Desktop, Claude Code, or Cursor.

Built by Jenny Ouyang.

Setup

1. Get your API token

Go to quickviralnotes.com/settings and generate an MCP API token.

2. Connect your AI assistant

Claude Desktop — add to your claude_desktop_config.json:

{
  "mcpServers": {
    "substack-notes": {
      "command": "npx",
      "args": ["-y", "substack-notes-mcp", "--token", "YOUR_TOKEN"]
    }
  }
}

Claude Code — run:

claude mcp add -s user substack-notes -- npx -y substack-notes-mcp --token YOUR_TOKEN

The -s user flag installs it globally so it's available in all your projects.

Cursor — add to your MCP settings:

{
  "mcpServers": {
    "substack-notes": {
      "command": "npx",
      "args": ["-y", "substack-notes-mcp", "--token", "YOUR_TOKEN"]
    }
  }
}

Or connect directly via Streamable HTTP:

• URL: https://qvn-mcp.vercel.app/mcp
• Header: Authorization: Bearer YOUR_TOKEN

Available Tools

| Tool | Description | |------|-------------| | get_notes_dashboard | View published and planned notes with category distributions | | get_published_notes | List your recently published notes | | get_planned_notes | View planned notes and open scheduling slots | | get_unscheduled_notes | Get notes ready to be scheduled | | create_note | Create a new note with HTML content and category | | schedule_note | Set or update the planned date for a note | | unschedule_note | Remove the planned date from a note | | mark_note_published | Mark a note as published with optional Substack URL | | fetch_substack_notes | Fetch published notes from any Substack author or publication (public, no cookies needed) | | fetch_note_comments | Fetch all comments and restacks for a specific note (public, no cookies needed) | | get_hook_templates | Browse 167 proven hook templates for crafting viral note openings | | add_hook_template | Add a new hook template to the library (admin-only) |

Requirements

• Node.js 18+
• A Quick Viral Notes account (free accounts can use read-only tools; creating and scheduling notes requires a subscription)

License

MIT