Partiful party invitations and rsvps MCP server: create invite, list RSVPs, export guest list.
dev.cotlet/partiful — Model Context Protocol (MCP) Server
The dev.cotlet/partiful MCP server provides an interface for event management tasks, focused on invites, guest lists, and text blasts. Its purpose is to support workflows around coordinating event attendees and sending event-related messages.
🛠️ Key Features
Invites
Guest lists
Text blasts
🚀 Use Cases
Sending event invitations
Maintaining a list of event guests
Broadcasting event messages via text blasts
⚡ Developer Benefits
Straightforward event-focused capabilities: invites, guest lists, and text blasts
⚠️ Limitations
Available details only describe invites, guest lists, and text blasts; no additional tools or capabilities are specified
The Cotlet account this connection acts as: email, workspace, access status, the API key or OAuth client in use with its scope, the apps the workspace may call and its credit balance. Free. Needs the user's Cotlet API key or sign-in.
The apps of the user's workspace and whether each works now: access granted or requested, the app account in the user's Cloud Browser (connected, signed out, not enabled for agents), and the one step the user has to take, with the console link. Free. Needs the user's Cotlet API key or sign-in.
Parameters1
app
string
optional
Only this app, e.g. skool.
Raw schema
{
"type": "object",
"properties": {
"app": {
"type": "string",
"description": "Only this app, e.g. skool."
}
},
"additionalProperties": false
}
cotlet_request_apps
Requests access to apps for the user's workspace, as Request access in the console: a live app is granted at once, any other goes to the Cotlet team, who answer within 72 hours. Takes app slugs as listed at https://cotlet.dev/api/v1/apps. Free. Needs the user's Cotlet API key or sign-in.
Status of an earlier Cotlet call, by its call_id: pending (waits for the owner's approval in the Cotlet console), approved, running, success, rejected, expired, blocked or failed. For a call that answered with status pending or running.
Returns a one-time upload_url and a file_id for a local file (an image for a post, an attachment). The file is sent to upload_url with an HTTP PUT; an argument that takes a file accepts {"file_id": "..."}. Up to 25 MB, the URL works once. Free. Needs the user's Cotlet API key or sign-in.
Sends a report straight to the Cotlet team: a tool that failed or returned wrong data, an error you could not get past, or a tool, field or app the task needed and Cotlet lacks. The report carries the error text and call_id when there is one, never passwords or tokens. Needs the user's Cotlet API key or sign-in.
Parameters7
kind
string
required
bug: a tool did the wrong thing or returned wrong data. error: a call failed or returned an error you could not get past. feature_request: something new the user wants. missing_feature: an app is here but lacks a tool, field or option the task needed. other: anything else.
title
string
required
One line, e.g. 'skool_list_members stops after 50 members'.
description
string
required
What you tried, what you expected and what happened, with the error text if there was one. No passwords, tokens or other secrets.
app
any
optional
App slug the report is about, e.g. 'skool'.
tool
any
optional
Tool or endpoint name, e.g. 'skool_list_members'.
call_id
any
optional
call_id of the call that went wrong, if any.
client
any
optional
Agent or tool sending this, e.g. 'Claude Code'.
Raw schema
{
"type": "object",
"properties": {
"kind": {
"description": "bug: a tool did the wrong thing or returned wrong data. error: a call failed or returned an error you could not get past. feature_request: something new the user wants. missing_feature: an app is here but lacks a tool, field or option the task needed. other: anything else.",
"enum": [
"bug",
"error",
"feature_request",
"missing_feature",
"other"
],
"title": "Kind",
"type": "string"
},
"title": {
"description": "One line, e.g. 'skool_list_members stops after 50 members'.",
"maxLength": 200,
"minLength": 3,
"title": "Title",
"type": "string"
},
"description": {
"description": "What you tried, what you expected and what happened, with the error text if there was one. No passwords, tokens or other secrets.",
"maxLength": 5000,
"minLength": 10,
"title": "Description",
"type": "string"
},
"app": {
"anyOf": [
{
"maxLength": 80,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "App slug the report is about, e.g. 'skool'.",
"title": "App"
},
"tool": {
"anyOf": [
{
"maxLength": 160,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Tool or endpoint name, e.g. 'skool_list_members'.",
"title": "Tool"
},
"call_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "call_id of the call that went wrong, if any.",
"title": "Call Id"
},
"client": {
"anyOf": [
{
"maxLength": 80,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Agent or tool sending this, e.g. 'Claude Code'.",
"title": "Client"
}
},
"required": [
"kind",
"title",
"description"
],
"additionalProperties": false,
"description": "Body of POST /api/v1/reports and the arguments of the MCP tool cotlet_report_issue.",
"title": "AgentReportCreate"
}
cotlet_browser_connect
Wakes the user's Cloud Browser of one app (a real Chrome on Cotlet, signed in to that app as the user) and returns cdp_url, a Chrome DevTools Protocol WebSocket that gives a CDP client full control of the browser. It works in one open tab, the app's: the user watches it live, and new tabs are refused. Every started minute of an open connection costs credits. Needs the user's Cotlet API key or sign-in.
Open Chrome DevTools connections to the user's Cloud Browsers with the minutes and credits each has cost so far, and the cdp_url links still valid. With close: true it ends the open connections and takes back the unused links, of one app or of all. Needs the user's Cotlet API key or sign-in.
Parameters1
close
boolean
optional
End the connections and revoke the links.
Raw schema
{
"type": "object",
"properties": {
"close": {
"type": "boolean",
"description": "End the connections and revoke the links."
}
},
"additionalProperties": false
}
cotlet_browser_open
Wakes the user's own browser on Cotlet, a real Chrome hosted for them: their web browser with the sites they signed in to there, or with `app` that app's browser, signed in to the app. Opens `url` when given and returns the page's URL and title. The user watches every step live. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in that browser.
Parameters1
url
string
optional
A public http or https address, e.g. https://example.com. In an app's browser, a page of that app.
Raw schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "A public http or https address, e.g. https://example.com. In an app's browser, a page of that app."
}
},
"additionalProperties": false
}
cotlet_browser_navigate
Opens a public http or https address in the user's browser on Cotlet and returns the URL and title it ended on. An app's browser opens only that app's pages. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in that browser.
Parameters1
url
string
required
A public http or https address, e.g. https://example.com. In an app's browser, a page of that app.
Raw schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "A public http or https address, e.g. https://example.com. In an app's browser, a page of that app."
}
},
"required": [
"url"
],
"additionalProperties": false
}
cotlet_browser_read
Returns the current page of the user's browser on Cotlet: its readable text, up to 20,000 characters, and a numbered list of its links, buttons and fields. Field values, cookies and storage are never returned. On a page longer than that, both start near where it is scrolled to. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in that browser.
Returns a JPEG image of the visible part of the current page in the user's browser on Cotlet, with its URL and title: boards, canvases and layouts that the page text does not show. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in that browser.
Scrolls the current page in the user's browser on Cotlet with the mouse wheel, as a person does: down or up by `screens` viewport heights (default 0.8), to the top or the bottom, or until element `element` is in view. Content that loads on scroll appears, and the next read lists it. Returns the URL, title and scroll position (at_top, at_bottom). Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in that browser.
Parameters3
direction
string
optional
Where to scroll. Default: down.
screens
number
optional
How far, in viewport heights, for down and up. Default: 0.8.
element
integer
optional
Scroll until this element of the element list is in view.
Raw schema
{
"type": "object",
"properties": {
"direction": {
"type": "string",
"enum": [
"down",
"up",
"top",
"bottom"
],
"description": "Where to scroll. Default: down."
},
"screens": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 10,
"description": "How far, in viewport heights, for down and up. Default: 0.8."
},
"element": {
"type": "integer",
"minimum": 1,
"description": "Scroll until this element of the element list is in view."
}
},
"additionalProperties": false
}
cotlet_browser_click
Clicks a link, button or other element of the current page in the user's browser on Cotlet, by its number in the page's element list, and returns the URL and title after the click. It acts as the user on that site. Buttons that pay or buy and buttons on account or sign-in pages are refused. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in that browser.
Parameters1
element
integer
required
The element's number in the element list of the current page.
Raw schema
{
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
}
},
"required": [
"element"
],
"additionalProperties": false
}
cotlet_browser_type
Types text into a field of the current page in the user's browser on Cotlet, by the field's number in the page's element list, and with `submit` presses Enter. Returns the URL and title after it. Password, card and one-time code fields and sign-in pages are refused: the user fills those in themselves. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in that browser.
Parameters3
element
integer
required
The element's number in the element list of the current page.
text
string
required
The text to type.
submit
boolean
optional
Press Enter after typing, e.g. to search.
Raw schema
{
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"text": {
"type": "string",
"maxLength": 5000,
"description": "The text to type."
},
"submit": {
"type": "boolean",
"description": "Press Enter after typing, e.g. to search."
}
},
"required": [
"element",
"text"
],
"additionalProperties": false
}
cotlet_browser_select
Chooses an option of a drop-down list on the current page in the user's browser on Cotlet, by the list's number in the element list and the option's label as read lists it (or its value). Returns the URL and title after it. Card fields and account pages are refused. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in that browser.
Parameters2
element
integer
required
The element's number in the element list of the current page.
option
string
required
The option.
Raw schema
{
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"option": {
"type": "string",
"maxLength": 300,
"description": "The option."
}
},
"required": [
"element",
"option"
],
"additionalProperties": false
}
cotlet_browser_press
Presses one key on the current page in the user's browser on Cotlet, on the element that has focus: Tab to the next field, Enter to send, Escape to close a dialog or pop-up, arrows to move through a suggestion list. Returns the URL and title after it. Enter on account pages is refused. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in that browser.
Puts files into a file field of the current page in the user's browser on Cotlet, or into the file picker that an upload button opens, by its number in the element list. A file is given as {"url": "https://..."} for a file online or {"file_id": "..."} for one uploaded to Cotlet first; up to 10 files, 20 MB each. Returns the URL and title after it. Every started minute of the session costs credits; it ends when closed or 3 minutes after the last call in that browser.
Parameters2
element
integer
required
The element's number in the element list of the current page.
files
array
required
The files.
Raw schema
{
"type": "object",
"properties": {
"element": {
"type": "integer",
"minimum": 1,
"description": "The element's number in the element list of the current page."
},
"files": {
"type": "array",
"minItems": 1,
"maxItems": 10,
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "A public file URL."
},
"file_id": {
"type": "string",
"description": "A file uploaded to Cotlet."
}
},
"additionalProperties": false
},
"description": "The files."
}
},
"required": [
"element",
"files"
],
"additionalProperties": false
}
cotlet_browser_close
Ends the session in the user's browser on Cotlet (with `app`, that app's browser): the browser keeps its cookies, goes to sleep and the per-minute charge stops. Returns the session's minutes and credits.
New event page. Nobody is invited until you call invite_guests.
Parameters11
title
string
required
Event title.
end_at
string
optional
End, ISO 8601. Optional; must be after start_at.
location
string
optional
Address, place name or link.
start_at
string
required
Start, ISO 8601. Without an offset it is read in the event's time zone.
timezone
string
optional
IANA zone the event is shown in, e.g. America/New_York. Default: the browser's zone.
questions
array
optional
Guest Questionnaire, short-answer questions asked at RSVP. An empty list turns it off.
max_guests
integer | null
optional
Guest limit; RSVPs over it go to the waitlist. null removes the limit.
visibility
string
optional
private: only people with the link (default). public: anyone on or off Partiful.
description
string
optional
Event details shown on the page.
rsvp_deadline
string
optional
Last moment guests can RSVP, ISO 8601.
guest_approval
boolean
optional
Guests ask to join and you approve them (Guest Approval). Clears max_guests.
Raw schema
{
"type": "object",
"properties": {
"title": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Event title."
},
"end_at": {
"type": "string",
"description": "End, ISO 8601. Optional; must be after start_at."
},
"location": {
"type": "string",
"maxLength": 300,
"description": "Address, place name or link."
},
"start_at": {
"type": "string",
"description": "Start, ISO 8601. Without an offset it is read in the event's time zone."
},
"timezone": {
"type": "string",
"description": "IANA zone the event is shown in, e.g. America/New_York. Default: the browser's zone."
},
"questions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 10,
"description": "Guest Questionnaire, short-answer questions asked at RSVP. An empty list turns it off."
},
"max_guests": {
"type": [
"integer",
"null"
],
"minimum": 1,
"description": "Guest limit; RSVPs over it go to the waitlist. null removes the limit."
},
"visibility": {
"enum": [
"private",
"public"
],
"type": "string",
"description": "private: only people with the link (default). public: anyone on or off Partiful."
},
"description": {
"type": "string",
"maxLength": 5000,
"description": "Event details shown on the page."
},
"rsvp_deadline": {
"type": "string",
"description": "Last moment guests can RSVP, ISO 8601."
},
"guest_approval": {
"type": "boolean",
"description": "Guests ask to join and you approve them (Guest Approval). Clears max_guests."
}
},
"required": [
"title",
"start_at"
],
"additionalProperties": false
}
delete_event
Delete an event you host for everyone, with its guest list. Waits for the owner's approval.
Copy an event with its settings to a new date. The copy has no guests yet.
Parameters3
title
string
optional
Title of the copy. Default: the same.
event_id
string
required
event_id from list_events.
start_at
string
required
Start of the copy, ISO 8601. Without an offset it is read in the event's time zone.
Raw schema
{
"type": "object",
"properties": {
"title": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Title of the copy. Default: the same."
},
"event_id": {
"type": "string",
"description": "event_id from list_events."
},
"start_at": {
"type": "string",
"description": "Start of the copy, ISO 8601. Without an offset it is read in the event's time zone."
}
},
"required": [
"event_id",
"start_at"
],
"additionalProperties": false
}
invite_guests
Invite past guests and mutuals through Partiful, or anyone by email. Waits for the owner's approval.
Parameters4
emails
array
optional
People to invite by email, with the name the invite greets.
message
string
optional
Personal note sent with the invites.
event_id
string
required
event_id from list_events.
user_ids
array
optional
user_id values from list_past_guests.
Raw schema
{
"type": "object",
"properties": {
"emails": {
"type": "array",
"items": {
"type": "object",
"required": [
"email",
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Shown on the invite."
},
"email": {
"type": "string",
"format": "email"
}
},
"additionalProperties": false
},
"maxItems": 500,
"description": "People to invite by email, with the name the invite greets."
},
"message": {
"type": "string",
"maxLength": 480,
"description": "Personal note sent with the invites."
},
"event_id": {
"type": "string",
"description": "event_id from list_events."
},
"user_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 1000,
"description": "user_id values from list_past_guests."
}
},
"required": [
"event_id"
],
"additionalProperties": false
}
send_text_blast
Text a message to guests by RSVP status. Partiful allows up to 10 Text Blasts per event. Waits for the owner's approval.
Parameters4
message
string
required
Message text.
event_id
string
required
event_id from list_events.
statuses
array
required
Who receives it: going, maybe, cant_go, invited, waitlist, pending.
show_on_event_page
boolean
optional
Also show the blast in the event's activity feed. Default: true.
Change the details or settings of an event you host.
Parameters11
title
string
optional
Event title.
end_at
string
optional
End, ISO 8601. Optional; must be after start_at.
event_id
string
required
event_id from list_events.
location
string
optional
Address, place name or link.
start_at
string
optional
Start, ISO 8601. Without an offset it is read in the event's time zone.
timezone
string
optional
IANA zone the event is shown in, e.g. America/New_York.
questions
array
optional
Guest Questionnaire, short-answer questions asked at RSVP. An empty list turns it off.
max_guests
integer | null
optional
Guest limit; RSVPs over it go to the waitlist. null removes the limit.
description
string
optional
Event details shown on the page.
rsvp_deadline
string
optional
Last moment guests can RSVP, ISO 8601.
guest_approval
boolean
optional
Guests ask to join and you approve them (Guest Approval). Clears max_guests.
Raw schema
{
"type": "object",
"properties": {
"title": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Event title."
},
"end_at": {
"type": "string",
"description": "End, ISO 8601. Optional; must be after start_at."
},
"event_id": {
"type": "string",
"description": "event_id from list_events."
},
"location": {
"type": "string",
"maxLength": 300,
"description": "Address, place name or link."
},
"start_at": {
"type": "string",
"description": "Start, ISO 8601. Without an offset it is read in the event's time zone."
},
"timezone": {
"type": "string",
"description": "IANA zone the event is shown in, e.g. America/New_York."
},
"questions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 10,
"description": "Guest Questionnaire, short-answer questions asked at RSVP. An empty list turns it off."
},
"max_guests": {
"type": [
"integer",
"null"
],
"minimum": 1,
"description": "Guest limit; RSVPs over it go to the waitlist. null removes the limit."
},
"description": {
"type": "string",
"maxLength": 5000,
"description": "Event details shown on the page."
},
"rsvp_deadline": {
"type": "string",
"description": "Last moment guests can RSVP, ISO 8601."
},
"guest_approval": {
"type": "boolean",
"description": "Guests ask to join and you approve them (Guest Approval). Clears max_guests."
}
},
"required": [
"event_id"
],
"additionalProperties": false
}
Partiful API and MCP server: connect Partiful to ChatGPT and Claude
Yes, ChatGPT, Claude and other AI agents can work in your Partiful account. That includes Cursor, Codex, OpenClaw and any MCP client, plus automations in n8n, Make and Zapier. Ask in plain words, and the AI creates events, sends updates to guests, reads RSVPs and exports guest lists. It shows you what it will do first and sends nothing to other people until you say so.
As of November 2026, this repo is the missing piece: 14 Partiful tools for AI assistants and scripts.
What you can ask
Who is going to Friday's dinner, and what dietary restrictions did they put in the questionnaire?
Approve all pending guests to my launch party who answered with a company name, and list the rest for me.
Copy last month's book club for November 14 at 7pm and invite the people who came.
Text everyone who is Going or Maybe to my rooftop dinner that the door code is 4512.
sign in to Partiful once, about 5 minutes, nothing to install
Python and a terminal
Works in
ChatGPT and Claude apps, on your phone too, Cursor, Codex, OpenClaw, any MCP client, n8n, Make, Zapier, REST API
Claude Code, Claude Desktop, Cursor, Codex on your computer
Runs
24/7, your computer can be off
while your computer is on
Price
7 days free, no card
free
Cotlet is best for hosts, community organisers and event teams who want ChatGPT, Claude or another AI agent to work in Partiful for them, with nothing to install.
A Partiful API and a Partiful MCP server you run on your own computer, in Python, on the session of your own Google Chrome. All 14 Partiful tools we run in production at Cotlet: events, guest lists with questionnaire answers, the Export CSV file, check-in, Guest Approval, invites and Text Blasts.
Partiful has no public API and no official MCP server. This repo gives you both:
MCP server for Claude Code, Claude Desktop, Cursor, Codex and any MCP client, over stdio or HTTP. Setup
REST API on http://127.0.0.1:8787/api/v1/partiful, with OpenAPI docs at /docs. Setup
Python: call("list_guests", event_id="..."), plus 9 ready scripts in examples/.
Free for your own use, your own business included (license).
Does Partiful have an API?
No. Partiful has no public API, no developer docs and no webhooks, and its help center documents no Zapier or Make connection. Guest data leaves Partiful only as a CSV you export by hand with the Export CSV button. This repo and Cotlet give you 14 Partiful tools as a REST API and an MCP server.
Can I get a Partiful API key?
Not from Partiful for your own account. With Cotlet you get your own API key that works with your Partiful account, for scripts, n8n, Make, Zapier or any HTTP client. This repo needs no key: it runs on your computer, on your own Partiful session.
Is there an official ChatGPT integration for Partiful?
No. Partiful has no official ChatGPT or Claude connector. Cotlet is an unofficial one that works today, in the ChatGPT and Claude apps and in any AI agent that takes an MCP server.
How do I connect Partiful to ChatGPT?
Sign up at cotlet.dev, sign in to Partiful once in your Cloud Browser there, and add Cotlet to ChatGPT, following the steps in your account. Then ask ChatGPT about your Partiful like you would ask an assistant. ChatGPT needs a server on the internet, so this repo alone, running on your computer, does not connect to ChatGPT.
Can ChatGPT create Partiful events for me?
Yes, with Cotlet. Describe the event, and it creates it with the time, place and description, then texts updates to guests after your OK.
Can I export my Partiful guest list?
Yes, with Cotlet: guests, RSVPs and answers to your questions for any event, without clicking Export CSV.
Can I automate Partiful with Zapier, Make or n8n?
Partiful has no Zapier or Make app. With Cotlet, n8n, Make and Zapier can create events and read RSVPs, for example into a sheet or your CRM.
Can I use it from my phone?
Yes, with Cotlet: once it is set up, the ChatGPT and Claude apps on your phone can use Partiful for you.
Do I need to be technical?
For Cotlet, no: you sign in to Partiful and add Cotlet to ChatGPT or Claude, with step-by-step instructions in your account. This repo is for people who are fine with Python and a terminal.
Is my Partiful account safe?
Yes. Neither Cotlet nor this repo sees or stores your Partiful password. You sign in yourself, the way you always do, and the AI works on that signed-in session. Anything that reaches other people asks for your OK first: in Cotlet by default, here through your MCP client.
Is it free?
This repo is free, also in your own business. Cotlet is free for 7 days with no card, then one-time credit packs from $29, no subscription. Pricing.
I manage Partiful for several accounts or clients. Does that work?
Yes, with Cotlet. Each Partiful login gets its own connection. Write to contact@cotlet.dev and tell us how many accounts you manage.
How it works
text
AI agent (MCP) / script (REST, Python) ──▶ partiful-mcp on your computer ──your Partiful sign-in──▶ api.partiful.com
▲ Firestore
partiful-mcp connect ───────┘ reads it once from your Chrome (DevTools Protocol)
You sign in to Partiful in your own Chrome, with your phone number and the code Partiful texts you.
partiful-mcp connect attaches to that Chrome through the Chrome DevTools Protocol. It reads the partiful.com cookies and, from a partiful.com tab, the signed-in user that the Partiful web app keeps in IndexedDB (Firebase, with its refresh token). If no Partiful tab is open, it opens one in the background and closes it again. Both are saved to ~/.config/partiful-api-mcp/session.json, readable by your user only.
Every tool call is a request to the endpoints the Partiful web app calls itself: its functions on api.partiful.com, and Firestore for guest lists and event edits. Requests go out with curl_cffi, which copies Chrome's TLS fingerprint. No headless browser runs.
Partiful's sign-in token lasts an hour. The server renews it from the saved refresh token at Google's securetoken.googleapis.com, the way the web app does, so you connect once and not every hour. When Partiful ends the session, the server reads it from Chrome again, if Chrome is open with remote debugging on.
Requirements
Python 3.11 or newer.
Google Chrome 144 or newer, signed in to Partiful on partiful.com. Any Chrome or Chromium works with a debugging port.
macOS, Linux or Windows.
A Partiful account that hosts the events. Reading and changing an event's guest list, approvals, check-in, invites and Text Blasts work for events you host or cohost. get_event opens any event your account can see.
With uv: uv venv && uv pip install -e ., then uv run partiful-mcp ....
Setting it up with an AI agent (Claude Code, Codex, Cursor)? Open it in this folder and ask it to set up the repo: AGENTS.md tells it every step, and it asks you only for the steps in Chrome.
To update: uv tool upgrade partiful-api-mcp (or pip install -U partiful-api-mcp), from source git pull && pip install -e .. We copy every change of the hosted Partiful tools into this repo.
Connect your Chrome
Option A: your everyday Chrome (recommended)
Open chrome://inspect/#remote-debugging in Chrome and switch remote debugging on. Chrome then accepts DevTools connections from programs on this computer, and asks you before each one.
Chrome asks whether to allow the connection. Click Allow.
text
Saved 16 Partiful cookies and 1 sign-in keys to /Users/you/.config/partiful-api-mcp/session.json
Signed in to Partiful as Maya Chen
You can switch remote debugging off again afterwards. Leave it on if you want the server to pick up a new session by itself after Partiful signs you out.
connect looks for Chrome's DevToolsActivePort file in the default profile folder. For Chrome Beta, Canary or a custom profile folder, pass --profile-dir "<folder>".
Option B: a Chrome with a debugging port
Chrome does not open a debugging port on your default profile, so start a separate one, sign in to Partiful there once, and connect to it:
--cdp also takes a ws:// DevTools URL, for example of a Chrome on another machine reached over an SSH tunnel.
There is no paste-a-cookie option. Partiful's API takes the signed-in user from the browser's IndexedDB, not a cookie, so connect needs a running Chrome once. After that the session file works on its own, also on a machine without Chrome.
Check the session at any time:
bash
partiful-mcp status
MCP server
The MCP server lists every tool with its input schema, a description written for agents, and hints: read tools are marked read-only, and tools that invite, text, approve or delete are marked so your client asks before running them.
Claude Code
bash
claude mcp add partiful -- uvx partiful-api-mcp mcp
# read only:
claude mcp add partiful -- uvx partiful-api-mcp mcp --read-only
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
partiful-mcp serve also serves MCP over streamable HTTP at http://127.0.0.1:8787/mcp, for clients that take a URL:
bash
partiful-mcp serve
claude mcp add --transport http partiful http://127.0.0.1:8787/mcp
Then ask your agent things like:
Who is going to Friday's dinner, and what dietary restrictions did they put in the questionnaire?
Approve all pending guests to my launch party who answered with a company name, and list the rest for me.
Copy last month's book club for November 14 at 7pm and invite the people who came.
Text everyone who is Going or Maybe to my rooftop dinner that the door code is 4512.
REST API
bash
partiful-mcp serve # http://127.0.0.1:8787, MCP at /mcp, docs at /docs
Each tool has its own route under /api/v1/partiful, the same paths as the hosted API at cotlet.dev, so code written against one works with the other. Path parts and the query string are arguments, and a JSON body adds the rest.
curl -X POST http://127.0.0.1:8787/api/v1/partiful/tools/list_guests -d '{"event_id": "hK3vQ9xLm2Pa7RtYc4Wd"}'
GET /api/v1/partiful/tools: every tool with its route, input schema and an example answer.
GET /docs: interactive OpenAPI docs, GET /openapi.json the schema, for n8n, Postman or a generated client.
Answers are JSON. Lists return next_cursor; pass it back as cursor for the next page.
The server listens on 127.0.0.1 only. To reach it from another device of yours, set a token, and every request then needs Authorization: Bearer <token>:
On a schedule, cron on your own computer works while it is on: 0 8 * * 1 cd ~/partiful-api-mcp-server && .venv/bin/python examples/export_rsvps.py --event <id> --status going --out rsvps.csv.
All 14 tools
event_id is the id in the event's link: hK3vQ9xLm2Pa7RtYc4Wd for partiful.com/e/hK3vQ9xLm2Pa7RtYc4Wd. list_events returns it. partiful-mcp tools prints this list, partiful-mcp tools --json adds the input schemas.
Events
Tool
Access
REST route
What it does
list_events
read
GET /events
Events you host, with date, status and guest counts.
get_event
read
GET /events/{event_id}
Full event: title, description, start and end, location, RSVP deadline, guest limit, Guest Approval and waitlist settings, link.
create_event
write
POST /events
New event page. Nobody is invited until you call invite_guests.
update_event
write
PATCH /events/{event_id}
Change the details or settings of an event you host.
duplicate_event
write
POST /events/{event_id}/duplicate
Copy an event with its settings to a new date. The copy has no guests yet.
cancel_event
write
POST /events/{event_id}/cancel
Cancel an event. Partiful notifies the guests.
delete_event
write
DELETE /events/{event_id}
Delete an event you host for everyone, with its guest list.
Guest list
Tool
Access
REST route
What it does
list_guests
read
GET /events/{event_id}/guests
Guests of an event with RSVP status, check-in and Guest Questionnaire answers.
export_guest_list
read
GET /events/{event_id}/guests/export
The guest list as CSV, the same file as the Export CSV button.
check_in_guests
write
POST /events/{event_id}/guests/check-in
Mark guests as checked in at the door, or undo it.
approve_guests
write
POST /events/{event_id}/guests/approve
Approve pending guests on a Guest Approval event.
Invites and Text Blasts
Tool
Access
REST route
What it does
list_past_guests
read
GET /past-guests
People you can invite: your past guests and mutuals.
invite_guests
write
POST /events/{event_id}/guests/invite
Invite past guests and mutuals through Partiful, or anyone by email.
send_text_blast
write
POST /events/{event_id}/text-blasts
Text a message to guests by RSVP status. Partiful allows up to 10 Text Blasts per event.
Not built: inviting phone numbers (Partiful takes phone contacts only in its app), rejecting or removing guests, changing a guest's RSVP, cohosts, comments and photos, replies to a Text Blast, tickets, themes and Discover. Never built, on purpose: your Partiful sign-in, phone number, name and profile, and anything that moves money. Every request passes a guard that refuses those Partiful paths.
Configuration
Variable
Default
What it does
PARTIFUL_MCP_HOME
~/.config/partiful-api-mcp
Folder of session.json.
PARTIFUL_PROXY
Proxy for every request to Partiful, e.g. http://user:pass@host:port.
PARTIFUL_MCP_READ_ONLY
1 hides and refuses every tool that changes Partiful (same as --read-only).
PARTIFUL_MCP_TOKEN
Bearer token required by serve; needed to listen beyond 127.0.0.1.
PARTIFUL_MCP_HOST, PARTIFUL_MCP_PORT
127.0.0.1, 8787
Address of serve.
Security and your Partiful account
No codes, no password. Partiful signs you in with a texted code. This code never asks for it: it reads the session Chrome already holds.
The session file is yours.session.json is created with mode 0600 and holds the partiful.com cookies and the Firebase refresh token. Anyone who has it can act as you on Partiful, so keep it out of git and shared folders.
Local by default.serve binds to 127.0.0.1 and refuses another address without PARTIFUL_MCP_TOKEN.
Three hosts only. Requests and redirects go only to partiful.com, securetoken.googleapis.com (token renewal) and firestore.googleapis.com (guest lists, event edits).
Read-only mode.--read-only or PARTIFUL_MCP_READ_ONLY=1 exposes the 5 read tools only.
Actions reach real people. Invites, Text Blasts, approvals and cancellations go out to real phones and inboxes at once, and a blast cannot be pulled back. MCP clients ask before running them; a script does not, so try it on a test event first.
Do not spam. Partiful caps Text Blasts at 10 per event and invites at 1,000 per event. You are responsible for what runs in your account.
Errors
The REST API answers {"error": "<code>", "message": "..."}. The MCP server returns the same code and message as a tool error.
Status
Code
What to do
401
auth_required, auth_expired
No session, or Partiful signed you out. Sign in to Partiful in Chrome and run partiful-mcp connect.
403
app_permission_denied
Only a host of the event can do this.
403
scope_denied
The server runs read-only, or the request would change your Partiful account.
403
target_blocked
Partiful refused the request or showed a bot check. Open partiful.com in Chrome once, then retry.
409
captcha_required
Partiful asks for a CAPTCHA. Solve it in Chrome.
422
invalid_input
An argument is missing or wrong; the message names it.
429
rate_limited
Partiful is limiting the account. Wait a few minutes.
502
target_error
Partiful answered with an error, or changed its site. git pull for the latest tools, or open an issue.
your Chrome, cookies and refresh token in a local file
your own Cloud Browser in the EU, profile encrypted with AES-256-GCM
When Partiful changes its site
git pull once we have fixed it
fixed for you, every tool tested daily
Approvals
your MCP client asks per call
invites, Text Blasts and approvals wait for your OK, switchable per tool
Works with
MCP clients on your machine, local scripts
Claude.ai and ChatGPT connectors, n8n, Make, Zapier, any HTTP client
Who may use it
you and your own business
you, teams, businesses, agencies
Price
free
free 7-day trial with 2,000 credits, no card; then one-time packs from $29 for 5,000 credits
On the hosted version a successful Partiful call uses 25 credits, failed calls are free, and the Cloud Browser uses 50 credits a day while it has an app enabled for agents. Full pricing.
FAQ
Is there a Partiful MCP server for Claude, ChatGPT or Cursor?
Yes, this one runs on your machine: partiful-mcp mcp for Claude Code, Claude Desktop, Cursor and Codex. ChatGPT and Claude.ai connectors need a public HTTPS URL, which the hosted Partiful MCP server gives you.
Can I export a Partiful guest list to CSV or Google Sheets?
Yes: python examples/export_guest_list.py --event <id> --out guests.csv saves the Export CSV file, and examples/export_rsvps.py gives one row per guest with a column per questionnaire question, for a sheet. Phone numbers and emails are not in either, as in Partiful's own export.
Can it send Text Blasts?
Yes, send_text_blast to the RSVP statuses you choose. Partiful allows 10 per event and does not say how many are left, and a blast to Invited works only up to 100 people. A sent blast cannot be edited or pulled back.
Can it invite people by phone number?
No. Partiful takes phone contacts only in its app. invite_guests invites Partiful users from list_past_guests and anyone by email.
Why does it need my Chrome?
To read your Partiful session without a texted code. Chrome is used once per sign-in, not for each call: the hourly token renewal goes to Google directly.
What happens when Partiful signs me out?
Calls fail with auth_expired. With Chrome remote debugging on, the server reads the new session on the next call (click Allow when Chrome asks); otherwise sign in on partiful.com and run partiful-mcp connect again.
Can it run on a VPS or in Docker?
Technically yes: connect once on a machine with Chrome and copy session.json to the server, into PARTIFUL_MCP_HOME. Partiful then sees your session from a datacenter IP, which looks less like you. For an always-on setup the hosted version keeps your session in your own Cloud Browser on a fixed IP.
Will my Partiful account get banned?
Requests carry Chrome's fingerprint and go out one at a time, as you would click. Nobody can promise a platform never acts. Keep to your normal use and do not blast or invite people who did not ask for it.
Can I use it at work or for my clients?
At work and in your own business, yes, free. You may not offer it to others as a hosted or managed service. For client work, use Cotlet or write to contact@cotlet.dev.
Is it open source?
The source is public under the Elastic License 2.0: free to use and change, also in your own business, but not to resell as a hosted service.
A tool broke or I need another one.Open an issue with the tool name and the error message.
Allowed: using it for yourself and in your own business, free. Changing the code and sharing it under the same license.
Not allowed: offering it to others as a hosted or managed service, removing the license notices, getting around its limits.
Maintained by Cotlet (@cotletdev). Partiful is a trademark of its owner. This project is unofficial and not affiliated with, endorsed or sponsored by Partiful.