patreon-mcp-server
Provides tools to access and read Patreon creator data, including campaigns, patrons (members), posts, and pledge information, enabling AI assistants to query creator analytics and supporter details.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@patreon-mcp-server Show me my Patreon campaigns"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Patreon MCP Server
mcp-name: io.github.KyuRish/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 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 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 things 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"
Related MCP server: Telegram Account MCP Connector
Available Tools
Tool | Description | Returns |
| Your authenticated profile |
|
| List all your campaigns |
|
| Campaign details with tier breakdown |
|
| Paginated patron list (100/page) |
|
| Paginated post list (20/page) |
|
| Single post by ID |
|
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
Privacy & Data
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.
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.pyProject Structure
src/patreon_mcp_server/
server.py # Entry point
mcp_server.py # FastMCP init + client instance
tools.py # @mcp.tool() definitions
models.py # Pydantic models + JSON:API parsers
utils/
client.py # PatreonClient (HTTP layer)Roadmap
This server is currently read-only. Write operations (create posts, manage tiers, send messages to patrons) will be added if there's enough demand - open an issue or star the repo to show interest.
License
MIT License - see LICENSE for details.
Support
If you find this useful, consider supporting development on Patreon.
Available Tools
6 toolsfetch_campaignC
Fetch details for a specific campaign including tiers.
Args: campaign_id: The campaign ID to fetch (numeric)
Inputs: campaign_id (required). Returns: campaign, tiers
fetch_campaignsA
Fetch all campaigns for the authenticated creator.
Inputs: no named parameters. Returns: result
fetch_identityA
Fetch the authenticated Patreon user's profile.
Inputs: no named parameters. Returns: id, full_name, email, image_url, +3 more
fetch_membersA
Fetch members/patrons of a campaign with pagination. Returns up to 100 members per page. Pass next_cursor from the response as cursor to get the next page.
Args: campaign_id: The campaign ID (numeric) cursor: Pagination cursor for next page (from previous response)
Inputs: campaign_id (required), cursor. Returns: members, next_cursor
fetch_postA
Fetch a specific post by ID.
Args: post_id: The post ID to fetch (numeric)
Inputs: post_id (required). Returns: id, title, content, is_paid, +7 more
fetch_postsA
Fetch posts from a campaign with pagination. Returns up to 20 posts per page. Pass next_cursor from the response as cursor to get the next page.
Args: campaign_id: The campaign ID (numeric) cursor: Pagination cursor for next page (from previous response)
Inputs: campaign_id (required), cursor. Returns: posts, next_cursor
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool fetches a distinct resource (campaign, campaigns, identity, members, post, posts) with clear singular/plural differentiation, so an agent can easily distinguish them.
All tool names follow the consistent pattern 'fetch_noun' (or 'fetch_nouns' for plurals), using lowercase and underscores without deviation.
6 tools is well-scoped for a Patreon API server covering core fetching of campaigns, identity, members, and posts, offering essential reads without bloat.
The server only provides read operations ('fetch_*') and lacks any create, update, or delete capabilities, which are essential for managing Patreon resources, leaving significant gaps.
Maintenance
Related MCP Connectors
Read-only access for your AI to Search Console, GA4, Google Ads, Meta Ads and your store's sales.
Securely review your Neuron business profile, services, calls, leads, bookings, and CRM data after account owner authorization. Read-only: the assistant can view only the Neuron account and permissions the owner approves.
Gives AI assistants read access to your Dedox help centre and knowledge base articles.
Amazon Ads, Seller Central, Vendor Central and AMC data for AI agents. Read-only by default.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants read-only access to Sprinklr data via MCP, allowing querying reports, searching cases, and calling Sprinklr API endpoints.8 npmISC
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to read chats, Saved Messages, files and media, search history, and send messages through your personal Telegram account.3MIT
- AlicenseAqualityCmaintenanceEnables AI assistants to access Saxo Bank portfolio data, account balances, positions, orders, transactions, and market data such as instruments, quotes, and charts. It is read-only by default, with trading tools available only when explicitly enabled.10MIT
- AlicenseBqualityBmaintenanceEnables AI agents to read WooCommerce store data and propose changes that require human approval before being applied, with read-only defaults and PII masking.16MIT