Skip to main content
Glama
README.md
# GoReminders MCP server

Connect GoReminders to ChatGPT, Claude, Codex and Claude Code through Cotlet.dev. Read appointments and customer replies, manage reminders and review booking requests in your own signed-in account. Review write operations before approving them.

## What you can ask

> Show tomorrow's appointments and customers who requested a reschedule.

> Show customer replies that need an answer.

> Draft a reminder message and show it 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 → add connector URL `https://cotlet.dev/mcp/v1/connect`, 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 repo is a real MCP server. It speaks MCP over stdio, lists its GoReminders 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 included Python module with Python 3.10 or later:

```bash
python3 goreminders_agent.py serve
```

Or with Docker:

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

Tools: `goreminders_guide`, `goreminders_status`, `goreminders_open`, `goreminders_read`, `goreminders_click`, `goreminders_type`, `goreminders_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+, with no third-party runtime dependencies. Clone this repository and run:

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

## Questions from GoReminders users

**How do I connect my account?**

Request access at https://cotlet.dev/signup?app=goreminders, sign in to GoReminders in your Cotlet.dev Cloud Browser and enable it for agents.

**Can I review changes?**

Write calls ask for confirmation by default; you can change that per tool. Creating an appointment schedules its reminders. Sending a text or message blast reaches customers and cannot be recalled.

**Which add-ons do I need?**

The live guide documents separate GoReminders add-ons for two-way messaging, message blasts, follow-ups and client self-scheduling. Your plan and enabled add-ons determine what is available.

**Is Cotlet.dev affiliated with GoReminders?**

No. Cotlet.dev is independent and not affiliated with GoReminders. Billing, add-ons, payment processing setup, team users and API users are outside the tools.

## Learn more

- [goreminders integration and hosted tools](https://cotlet.dev/integrations/goreminders-api-mcp-server)

---

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

Request access: https://cotlet.dev/signup?app=goreminders&utm_source=github&utm_medium=readme&utm_campaign=goreminders

## Workflows on the hosted integration

Examples documented on the live integration page:

- `list_appointments`
- `create_appointment`
- `update_appointment`
- `set_appointment_status`
- `list_messages`
- `send_message`
- `send_message_blast`
- `manage_files`
- `manage_message_templates`
- `manage_message_sequences`
- `manage_booking_requests`
- `manage_booking_settings`
- `manage_customers`
- `manage_customer_groups`
- `manage_setup_items`

The local stdio adapter exposes seven browser helpers listed above. These helpers forward to Cotlet.dev; the workflow operations are documented on the hosted integration page.

TDQS

A3.7/5.0

Scored across 7 tools

Disambiguation4/5

Each tool has a clear role: guide/status for setup, open/read/click/type/close for browser interaction. There is slight overlap between open and status in readiness context, but the descriptions distinguish them well. An agent can reliably choose the right action.

Naming Consistency5/5

All tools use the same goreminders_ prefix followed by a concise snake_case verb or noun. The pattern is consistent and predictable. No mixed casing or conflicting naming styles.

Tool Count5/5

Seven tools are well scoped for a guided browser automation server. Each tool maps to a distinct step in the workflow: onboarding, session management, and page interaction. There are no redundant tools.

Completeness4/5

The surface covers the core browser lifecycle: open, read, click, type, and close, plus guide and status. Minor gaps exist for navigation actions like scrolling or pressing Enter, but most workflows can be handled through clicking and typing. Overall the tool set is complete for the stated GoReminders use case.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues