# Partiful by Cotlet

Connects AI agents to Partiful for guest lists, event management, and text blasts through your Chrome session. Useful when automating event operations locally.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2
- Author: cotletdev
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cotletdev/partiful-api-mcp-server
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/partiful-by-cotlet

## What it 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.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://cotlet.dev/mcp/v1/partiful/connect`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http partiful https://cotlet.dev/mcp/v1/partiful/connect
```

2. **Platform CLI**
```bash
claude mcp add partiful-by-cotlet -- uvx partiful-api-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from partiful-api-mcp <command>

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add partiful-by-cotlet --url https://cotlet.dev/mcp/v1/partiful/connect
```

2. **Platform CLI**
```bash
codex mcp add partiful-by-cotlet -- uvx partiful-api-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from partiful-api-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "partiful-by-cotlet": {
            "url": "https://cotlet.dev/mcp/v1/partiful/connect"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "partiful-by-cotlet": {
            "type": "http",
            "url": "https://cotlet.dev/mcp/v1/partiful/connect"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http partiful-by-cotlet https://cotlet.dev/mcp/v1/partiful/connect
```

2. **Platform CLI**
```bash
gemini mcp add partiful-by-cotlet uvx partiful-api-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from partiful-api-mcp <command>

## When to use it
- 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
- 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

## Similar
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32260
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23283
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13181
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12826

---
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