Skip to content
Back to search

joy-mcp

Connect Joy to ChatGPT, Claude and other AI agents through Cotlet.dev.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/cotlet-connect--joy-mcp/badge.svg)](/listings/cotlet-connect--joy-mcp)

HTML

<a href="/listings/cotlet-connect--joy-mcp"><img src="/api/listings/cotlet-connect--joy-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 104 lines
  1. # Joy API and MCP server for ChatGPT and Claude
  2. 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.
  3. ## What you can ask
  4. > Show guests who have not responded to the RSVP.
  5. > Count meal choices for the caterer.
  6. > Prepare an RSVP reminder for my approval.
  7. > Read the wedding schedule.
  8. > Review received gifts and prepare thank-you notes.
  9. ## Connect Joy
  10. 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`.
  11. ### ChatGPT
  12. Add `https://cotlet.dev/mcp/v1/connect` as a connector and sign in with Cotlet.dev.
  13. ### Claude
  14. Add `https://cotlet.dev/mcp/v1/connect` in Settings > Connectors and sign in with Cotlet.dev.
  15. ### Claude Code
  16. ```bash
  17. claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"
  18. ```
  19. ### Cursor
  20. Copy `.cursor/mcp.json` from this repo into your project:
  21. ```json
  22. {
  23. "mcpServers": {
  24. "cotlet": {
  25. "url": "https://cotlet.dev/mcp/v1",
  26. "headers": {
  27. "Authorization": "Bearer ${COTLET_API_KEY}"
  28. }
  29. }
  30. }
  31. }
  32. ```
  33. ## Local browser adapter (stdio)
  34. 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.
  35. Run the adapter directly from this repository:
  36. ```bash
  37. export COTLET_API_KEY="your-key"
  38. python3 joy_agent.py serve
  39. ```
  40. Or with Docker:
  41. ```bash
  42. docker build -t joy-mcp .
  43. docker run -i --rm -e COTLET_API_KEY joy-mcp
  44. ```
  45. Tools: `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".
  46. ## Command line
  47. Python 3.10+, using the standard library. From this repository:
  48. ```bash
  49. export COTLET_API_KEY="your-key"
  50. python3 joy_agent.py connect # ready config for Claude Code, Cursor, ChatGPT
  51. python3 joy_agent.py status # is Joy ready in your Cotlet.dev account
  52. python3 joy_agent.py guide # Joy screens and sign-in link
  53. python3 joy_agent.py read # open Joy, read the page, close the browser
  54. python3 joy_agent.py tools # list Cotlet.dev tools
  55. python3 joy_agent.py serve # start the stdio MCP server (same as no argument)
  56. ```
  57. ## Questions from Joy users
  58. **Does Joy have a public API or MCP server?**
  59. The Cotlet.dev integration page reports no public Joy API or MCP server, checked 24 October 2026. Cotlet.dev provides a hosted connection.
  60. **What can I do with Joy through Cotlet.dev?**
  61. 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.
  62. **Is this an official Joy integration?**
  63. No. Cotlet.dev is independent and is not affiliated with Joy.
  64. ## Source
  65. https://cotlet.dev/integrations/joy-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=joy
  66. Start here: https://cotlet.dev/signup?app=joy

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.