Patreon

Provides read-only access to Patreon creator data via MCP, enabling AI assistants to query campaigns, patrons, posts, and more.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

Patreon MCP Server lets you securely grant AI assistants access to your Patreon creator data for read-only queries about campaigns, patrons, posts, and more. It is designed to work with MCP-compatible clients so you can ask questions like which patrons support you the most, how many patrons are on each tier, or what your latest posts are.

How to use

To use this MCP server, you start it with your Patreon access token and connect your MCP client to the local server. The server exposes a set of read-only tools that your AI assistant can call to retrieve your Patreon data. You will manage the token locally and keep it secure.

How to install

Prerequisites: Python 3.11 or newer and the uv package manager.

Step 1. Clone the project repository and move into the directory.

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

# Install dependencies
uv sync

# Start the server (test run)
PATREON_ACCESS_TOKEN=your_token uv run src/server.py

Additional notes

This server is read-only and does not cache or persist any data. It avoids requesting patron emails and private notes, and it does not perform write operations. When used with an AI assistant, patron data may be sent to the AI provider and processed per their policies. Ensure your use complies with Patreon's Creator Privacy Promise and applicable data protection laws.

Privacy & Data

The server emphasizes privacy: no patron emails are retrieved, no private notes are stored, and all interactions are read-only. No data is cached by the MCP server itself.

Project structure

Key components include the entry point, MCP initialization, tooling definitions, data models, and a Patreon HTTP client used for data retrieval.

Security considerations

Keep your Patreon access token secure and do not share it publicly. Use token management best practices and rotate tokens if needed.

Troubleshooting

If you encounter connection issues, verify that the access token is valid and that the server process is running. Check that your MCP client is configured to point to the correct local host and port if applicable.

Available tools

fetch_identity

Fetches your authenticated user profile from Patreon.

fetch_campaigns

Retrieves a list of your Patreon campaigns.

fetch_campaign

Retrieves detailed information about a single campaign, including tier breakdowns.

fetch_members

Fetches a paginated list of patrons with optional pagination cursor.

fetch_posts

Fetches a paginated list of posts from your campaigns.

fetch_post

Retrieves a single post by its ID.