Skip to main content
Glama
SignUpGenius MCP server

SignUpGenius MCP server

README.md
# SignUpGenius MCP server for ChatGPT and Claude

SignUpGenius has an official API for reads and adding group members. Cotlet.dev connects ChatGPT, Claude and other AI agents to your signed-in organizer account for creating sign-ups, managing slots and participants, and preparing group messages. Cotlet.dev is independent and is not affiliated with SignUpGenius, Inc. or Lumaverse Technologies.

## What you can ask

> Create a draft sign-up with roles, dates and head counts from my message.

> Show open slots across the sign-ups I created.

> Copy last year's sign-up into an unpublished draft.

> Move a participant to another open slot on the same sign-up after I approve.

> Draft an email reminding group members to fill open slots, then ask before sending.

## Connect in 2 minutes

Get your API key at https://cotlet.dev/app and export it as `COTLET_API_KEY`.

### ChatGPT

Settings → Apps & Connectors → Create, use `https://cotlet.dev/mcp/v1/connect` with OAuth, then sign in with Cotlet.dev. No API key needed.

### Claude Code

```bash
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:

```json
{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${COTLET_API_KEY}"
      }
    }
  }
}
```

## Run it locally (stdio)

This repository provides seven general browser tools over stdio and forwards calls to the hosted Cotlet.dev server. The 15 organizer operations described on the live page are separate from these local browser controls. The hosted URL above stays the recommended way. Use this when your client only starts local servers.

```json
{"mcpServers":{"signupgenius":{"command":"uvx","args":["--from","git+https://github.com/cotlet-connect/signupgenius-mcp","signupgenius-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}
```

Or with Docker:

```bash
docker build -t signupgenius-mcp .
docker run -i --rm -e COTLET_API_KEY signupgenius-mcp
```

Tools: `signupgenius_guide`, `signupgenius_status`, `signupgenius_open`, `signupgenius_read`, `signupgenius_click`, `signupgenius_type`, `signupgenius_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+, nothing else to install. Install directly from this repository:

```bash
pip install git+https://github.com/cotlet-connect/signupgenius-mcp
signupgenius-mcp connect
```

Or straight from this repo:

```bash
export COTLET_API_KEY="your-key"
python3 signupgenius_agent.py connect   # ready config for Claude Code, Cursor, ChatGPT
python3 signupgenius_agent.py status    # is SignUpGenius ready in your Cotlet.dev account
python3 signupgenius_agent.py guide     # SignUpGenius screens and sign-in link
python3 signupgenius_agent.py read      # open SignUpGenius, read the page, close the browser
python3 signupgenius_agent.py tools     # list Cotlet.dev tools
python3 signupgenius_agent.py serve     # start the stdio MCP server (same as no argument)
```

## Questions from SignUpGenius users

**Does SignUpGenius have an API?**

Yes. The live Cotlet.dev page describes official API reads and adding group members on paid plans. Cotlet.dev works through your own signed-in organizer account.

**How do I connect SignUpGenius to ChatGPT or Claude?**

Sign up at https://cotlet.dev/signup?app=signupgenius, enable SignUpGenius and sign in to your organizer account in the Cloud Browser. Add Cotlet using the connector instructions in your console.

**Can the agent join another organizer's sign-up?**

No. The described tools work on sign-ups you created as the organizer.

**Does publishing a sign-up email my group?**

No. Publishing returns the public link. Sending an email is a separate action that asks for approval by default.

**What runs in this repository?**

A local MCP adapter with seven browser tools. The live page describes 15 hosted organizer operations; the local adapter exposes general browser controls for the same signed-in app.

## Find it on

- [SignUpGenius on Cotlet.dev](https://cotlet.dev/integrations/signupgenius-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=signupgenius&utm_content=find)

## Also works with


- [All apps connected through Cotlet.dev](https://github.com/cotlet-connect)

---

More: https://cotlet.dev/integrations/signupgenius-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=signupgenius

Start free: https://cotlet.dev/signup?app=signupgenius&utm_source=github&utm_medium=readme&utm_campaign=signupgenius