Joy MCP Server
OfficialClick 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., "@Joy MCP Server Show me guests who haven't responded to the RSVP yet."
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.
Joy API and MCP server for ChatGPT and Claude
Connect ChatGPT, Claude and other AI agents to Joy through Cotlet.dev for wedding guests, RSVPs, schedules, registry gifts and messages. The live Cotlet.dev page describes 15 hosted Joy operations. Joy has no public API or MCP server according to that page, checked 24 October 2026.
What you can ask
Show guests who have not responded to the RSVP.
Count meal choices for the caterer.
Prepare an RSVP reminder for my approval.
Read the wedding schedule.
Review received gifts and prepare thank-you notes.
Related MCP server: Weezevent MCP Server
Connect Joy
Start at https://cotlet.dev/signup?app=joy, sign in to Joy in its Cloud Browser and enable it for agents. For editors and scripts, create your API key in the Cotlet.dev console and export it as COTLET_API_KEY.
ChatGPT
Add https://cotlet.dev/mcp/v1/connect as a connector and sign in with Cotlet.dev.
Claude
Add https://cotlet.dev/mcp/v1/connect in Settings > Connectors and sign in with Cotlet.dev.
Claude Code
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"Cursor
Copy .cursor/mcp.json from this repo into your project:
{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": {
"Authorization": "Bearer ${COTLET_API_KEY}"
}
}
}
}Local browser adapter (stdio)
This repo contains a local MCP adapter for the hosted Cotlet.dev Cloud Browser. The seven local browser helpers below are distinct from the 15 Joy operations documented on the integration page. It speaks MCP over stdio, lists its Joy tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.
Run the adapter directly from this repository:
export COTLET_API_KEY="your-key"
python3 joy_agent.py serveOr with Docker:
docker build -t joy-mcp .
docker run -i --rm -e COTLET_API_KEY joy-mcpTools: joy_guide, joy_status, joy_open, joy_read, joy_click, joy_type, joy_close. Without COTLET_API_KEY a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".
Command line
Python 3.10+, using the standard library. From this repository:
export COTLET_API_KEY="your-key"
python3 joy_agent.py connect # ready config for Claude Code, Cursor, ChatGPT
python3 joy_agent.py status # is Joy ready in your Cotlet.dev account
python3 joy_agent.py guide # Joy screens and sign-in link
python3 joy_agent.py read # open Joy, read the page, close the browser
python3 joy_agent.py tools # list Cotlet.dev tools
python3 joy_agent.py serve # start the stdio MCP server (same as no argument)Questions from Joy users
Does Joy have a public API or MCP server?
The Cotlet.dev integration page reports no public Joy API or MCP server, checked 24 October 2026. Cotlet.dev provides a hosted connection.
What can I do with Joy through Cotlet.dev?
Read guests, RSVP summaries, schedules and received gifts; update guests, tags, schedule events and registry gifts; prepare reminders, messages and thank-you notes. Review recipients and message contents before sending.
Is this an official Joy integration?
No. Cotlet.dev is independent and is not affiliated with Joy.
Source
Start here: https://cotlet.dev/signup?app=joy
Available Tools
7 toolsjoy_clickB
Click a numbered element on the current Joy page.
Inputs: element (required).
joy_closeA
Close the Joy browser session when the work is done, so credits stop running.
Inputs: no named parameters.
joy_guideA
How to work in Joy (wedding guests, RSVPs, schedules, registry gifts and messages): its screens and the sign-in link. Call this first.
Inputs: task.
joy_openB
Open a Joy page in your signed-in Cloud Browser (default https://withjoy.com) to work with wedding guests, RSVPs, schedules, registry gifts and messages.
Inputs: url.
joy_readA
Read the current Joy page: its text and numbered buttons, links and fields.
Inputs: element.
joy_statusA
Check that your Cotlet.dev account and Joy are ready: account, credits and Joy connection.
Inputs: no named parameters.
joy_typeB
Type text into a numbered field on the current Joy page.
Inputs: text (required), element (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool maps to a distinct step in a browser-automation workflow: orientation (guide/status), session control (open/close), and page interaction (read/click/type). There is no meaningful overlap between any pair, and the descriptions reinforce ordering (guide first, close last).
All seven tools use a uniform joy_ prefix with a single lowercase verb (guide, status, open, read, click, type, close). The pattern is predictable and immediately readable.
Seven tools is well-scoped for a browser-driven site automation set: two onboarding/context tools, two session tools, and three interaction primitives. Nothing feels redundant or padded.
The lifecycle is well covered: orient, verify readiness, open session, read page, act, and close. Minor gaps exist for common browser needs like scrolling, keyboard/enter submission, screenshots, or handling multiple tabs, which agents would have to work around with click/type alone.
Related MCP Connectors
Zola MCP server for ChatGPT, Claude and any AI agent: list guests, add guest, track RSVPs, list registry gifts and mark thank-you sent in your own Zola account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Zola yourself; Cotlet does not store your password and you need no Zola API key. About the official Zola API: Zola has no public API, developer docs or webhooks for couples (checked 11 Oct 2026). Guest list, RSVP and gift data leave Zola only as files you download by hand from a desktop browser. Setup and FAQ: https://cotlet.dev/integrations/zola-api-mcp-server
Joy MCP server for ChatGPT, Claude and any AI agent: list guests, add guest, get RSVP status, update event details and list registry gifts in your own Joy account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Joy yourself; Cotlet does not store your password and you need no Joy API key. About the official Joy API: Joy has no public API, no developer program and no Zapier app (checked 11 Oct 2026). Guests, RSVPs and the registry are managed in the Joy dashboard, and the guest list leaves Joy only as a CSV file you download by hand. Setup and FAQ: https://cotlet.dev/integrations/joy-api-mcp-server
Perfect Venue MCP server for ChatGPT, Claude and any AI agent: list events, create lead, update event details, send proposal and list payments in your own Perfect Venue account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Perfect Venue yourself; Cotlet does not store your password and you need no Perfect Venue API key. About the official Perfect Venue API: Perfect Venue has one public API, the Leads API: a write-only endpoint that creates a lead from your own contact form, and only on the Enterprise plan (checked 11 Oct 2026). Events, payments, messages and proposals cannot be read or changed by API. Setup and FAQ: https://cotlet.dev/integrations/perfect-venue-api-mcp-server
Evite MCP server for ChatGPT, Claude and any AI agent: create event, add guests, get RSVPs, message guests and update event in your own Evite account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Evite yourself; Cotlet does not store your password and you need no Evite API key. About the official Evite API: Evite has no public API and no official MCP server (checked 11 Oct 2026). Events, guest lists, RSVPs and guest messages can only be handled in the Evite website and apps, and its help center names no developer docs or webhooks. Setup and FAQ: https://cotlet.dev/integrations/evite-api-mcp-server
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables users to manage wedding preparation tasks including timeline generation, budget review, vendor quote comparison, role assignment briefs, and drafting messages for family, vendors, and friends.-
- AlicenseAqualityBmaintenanceConnects users' Weezevent accounts to ChatGPT, Claude, and other AI agents through Cotlet, enabling event, order, attendee, discount-code, invitation, and refund workflows with approval before actions that affect other people.7Elastic 2.0
- AlicenseAqualityBmaintenanceConnects a signed-in GoReminders account to ChatGPT, Claude, and other AI agents through Cotlet.dev, letting them read appointments and customer replies, manage reminders, and review booking requests, with write operations requiring approval before they run.7Elastic 2.0
- AlicenseNot gradedqualityCmaintenanceConnects Fitsly coach accounts to ChatGPT, Claude, and AI agents through Cotlet.dev, exposing hosted tools for clients, training, nutrition, habits, messages, and packages with approval-gated write actions.Elastic 2.0