Patreon MCP Server

🚀 Patreon MCP Server

Give AI assistants access to your Patreon creator data. The first authenticated Patreon MCP server - works with Claude Desktop, Cursor, Windsurf, VS Code Copilot, and any MCP-compatible client.

🚀 Quick Start

1. Get your Creator Access Token

Go to Patreon Developer Portal and copy your Creator Access Token. This token gives access to your own campaign data only.

2. Configure your MCP client

• Claude Desktop: Add the following to claude_desktop_config.json:

{
  "mcpServers": {
    "patreon": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/patreon-mcp-server", "src/patreon_mcp_server/server.py"],
      "env": {
        "PATREON_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

• Claude Code: Add the following to .mcp.json in your project root:

{
  "mcpServers": {
    "patreon": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/patreon-mcp-server", "src/patreon_mcp_server/server.py"],
      "env": {
        "PATREON_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

3. Start using it

Ask your AI assistant questions like:

• "Show me my Patreon campaigns"
• "Who are my top patrons by lifetime support?"
• "How many patrons are on each tier?"
• "Which patrons have declining payments?"
• "List my recent posts"

✨ Features

This server provides access to various Patreon data through a set of tools.

📦 Installation

Prerequisites

• Python 3.11+
• uv package manager

# Clone the repo
git clone https://github.com/kyurish/patreon-mcp-server.git
cd patreon-mcp-server

# Install dependencies
uv sync

# Test it runs
PATREON_ACCESS_TOKEN=your_token uv run src/patreon_mcp_server/server.py

💻 Usage Examples

Basic Usage

Ask your AI assistant things like:

"Show me my Patreon campaigns"

📚 Documentation

Available Tools

Pagination: fetch_members and fetch_posts return a next_cursor field. Pass it as the cursor parameter to fetch the next page.

Data Fields

Member

full_name, patron_status, pledge_cadence, lifetime_support_cents, currently_entitled_amount_cents, last_charge_date, last_charge_status, will_pay_amount_cents, is_follower, tiers, user_name

Campaign

creation_name, patron_count, pledge_url, published_at, url, vanity, is_monthly, created_at, image_url, summary, one_liner, pay_per_name

Tier

title, amount_cents, description, published, patron_count

Post

title, content, is_paid, is_public, published_at, url, embed_data, embed_url

🔧 Technical Details

This server is designed with patron privacy in mind:

• No patron emails: Email addresses are never requested from the API.
• No private notes: Creator notes about patrons are excluded.
• Read-only: No write operations, the server only reads your data.
• No data storage: The MCP server itself does not cache or persist any data.

Important: When using this server with an AI assistant, patron data (names, pledge amounts, charge status) is sent to your AI provider (e.g., Anthropic, OpenAI) and may be temporarily retained per their data processing policies. You are responsible for ensuring your use complies with Patreon's Creator Privacy Promise and applicable data protection laws.

This project is not affiliated with or endorsed by Patreon.

📄 License

This project is under the MIT License. See LICENSE for details.

Support

If you find this useful, consider supporting development on Patreon.