# patreon-mcp-server

Connects your AI client to Patreon creator metrics, tiers, and posts. Useful for tracking memberships and pledges directly in your coding environment.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Author: KyuRish
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/KyuRish/patreon-mcp-server
- Updated: 2026-03-07
- HTML: https://affpapa.org/en/nevibecode/mcp/patreon-mcp-server

## What it does

This server bridges an AI client with creator accounts on Patreon. Under the hood, it uses FastMCP alongside Pydantic models to parse incoming JSON:API structures. It provides six specific tools to read profile details, list active campaigns, pull posts (twenty items per page), and paginate through members (one hundred per page).

Member privacy is a deliberate design choice. The tools never query patron email addresses or private creator notes. Operation is strictly read-only, which means your assistant cannot publish posts, edit pledge tiers, or message patrons.

Running the code requires Python 3.11+ and the `uv` tool. Before launching, create an access token inside the Patreon developer portal and export it via the `PATREON_ACCESS_TOKEN` environment variable.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `PATREON_ACCESS_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add patreon-mcp-server -e PATREON_ACCESS_TOKEN=<PATREON_ACCESS_TOKEN> -- uvx patreon-mcp-server
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from patreon-mcp-server <command>

### Codex

**Platform CLI**
```bash
codex mcp add patreon-mcp-server --env PATREON_ACCESS_TOKEN=<PATREON_ACCESS_TOKEN> -- uvx patreon-mcp-server
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from patreon-mcp-server <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "patreon-mcp-server": {
            "command": "uvx",
            "args": [
                "patreon-mcp-server"
            ],
            "env": {
                "PATREON_ACCESS_TOKEN": "<PATREON_ACCESS_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from patreon-mcp-server <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "patreon-mcp-server": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "patreon-mcp-server"
            ],
            "env": {
                "PATREON_ACCESS_TOKEN": "<PATREON_ACCESS_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from patreon-mcp-server <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e PATREON_ACCESS_TOKEN=<PATREON_ACCESS_TOKEN> patreon-mcp-server uvx patreon-mcp-server
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from patreon-mcp-server <command>

## When to use it
- identify patrons with declined subscription charges
- break down active subscriber counts across membership tiers
- review recent campaign posts and publication timestamps
- rank top supporters by their lifetime contribution total

## Example prompts
- "Which patrons currently have failed or declining payments?"
- "Break down the member count across each campaign tier."
- "Show the top supporters ranked by lifetime support amount."

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44591
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5469
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2817
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2197
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md