Partiful by Cotlet — Claude Code MCP server: setup guide
Connects AI agents to Partiful for guest lists, event management, and text blasts through your Chrome session. Useful when automating event operations locally.
claude mcp add --transport http partiful https://cotlet.dev/mcp/v1/partiful/connectWhat Partiful by Cotlet does
Partiful lacks a public developer interface. This integration bridges that gap by offering 14 tools covering event retrieval, guest questionnaires, CSV exports, approvals, and mass text messages. The script attaches to your running Google Chrome instance via DevTools Protocol, reads the active login session, and writes credentials to ~/.config/partiful-api-mcp/session.json.
Outgoing network requests rely on curl_cffi to replicate the TLS profile of Chrome directly. You get no memory penalty from headless browser instances. Beside stdio MCP communication, the package also hosts a local REST service on port 8787.
Running this setup requires Python 3.11+ alongside Google Chrome 144 or newer. The code ships under the PolyForm Noncommercial 1.0.0 license, which prevents commercial deployment. Account actions remain restricted to gatherings where you hold host or cohost permissions.
What it helps with
- export attendee survey answers into a CSV file
- process guest approvals for upcoming gatherings
- trigger Text Blasts to confirmed party attendees
- check in arriving guests at an event
Example prompts for the agent
- List all Partiful events organized by my account
- Export guest survey responses for event
event_id - Send a Text Blast announcement to all confirmed guests
How to install Partiful by Cotlet
1Platform CLI: remote server
claude mcp add --transport http partiful https://cotlet.dev/mcp/v1/partiful/connect2Platform CLI
claude mcp add partiful-by-cotlet -- uvx partiful-api-mcpuvx runs the command named after the package; if the README names another one, use uvx --from partiful-api-mcp <command>
1Platform CLI: remote server
codex mcp add partiful-by-cotlet --url https://cotlet.dev/mcp/v1/partiful/connect2Platform CLI
codex mcp add partiful-by-cotlet -- uvx partiful-api-mcpuvx runs the command named after the package; if the README names another one, use uvx --from partiful-api-mcp <command>
Config file
{
"mcpServers": {
"partiful-by-cotlet": {
"url": "https://cotlet.dev/mcp/v1/partiful/connect"
}
}
}{
"mcpServers": {
"partiful-by-cotlet": {
"command": "uvx",
"args": [
"partiful-api-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from partiful-api-mcp <command>
Config file
{
"servers": {
"partiful-by-cotlet": {
"type": "http",
"url": "https://cotlet.dev/mcp/v1/partiful/connect"
}
}
}{
"servers": {
"partiful-by-cotlet": {
"type": "stdio",
"command": "uvx",
"args": [
"partiful-api-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from partiful-api-mcp <command>
1Platform CLI: remote server
gemini mcp add -t http partiful-by-cotlet https://cotlet.dev/mcp/v1/partiful/connect2Platform CLI
gemini mcp add partiful-by-cotlet uvx partiful-api-mcpuvx runs the command named after the package; if the README names another one, use uvx --from partiful-api-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Partiful by Cotlet
How to install Partiful by Cotlet in Claude Code?
Add the local runner with claude mcp add partiful-by-cotlet -- uvx partiful-api-mcp or connect to the hosted endpoint using claude mcp add --transport http partiful-by-cotlet https://cotlet.dev/mcp/v1/partiful/connect.
What does Partiful by Cotlet do?
It exposes 14 event management actions for Partiful, handling guest records, approvals, CSV exports, and text broadcasts directly within MCP environments.
What dependencies are needed before running the server?
You need Python 3.11 or newer and Google Chrome 144+ logged into partiful.com, followed by running partiful-mcp connect to link your session.
