# Easy!Appointments

This MCP server for Claude Code connects an AI assistant to an Easy!Appointments booking system. It finds available times and manages appointments after OAuth sign-in.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: qiyuanlabs-ai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qiyuanlabs-ai/easyappointments-mcp
- Updated: 2026-11-01
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/easyappointments

## What it does

The server can list services, search open times and find customers by name, email or phone. After OAuth sign-in, an assistant can create bookings, move them or cancel future appointments. Access is limited by the Read only or Front desk level.

Changes require a preview followed by a separate confirmation. The server keeps a call log with masked personal details. It requires Easy!Appointments 1.5 or newer with the API enabled and an API token, plus PHP 8.3 or Docker. A public server needs HTTPS.

## Requirements
- Remote server: `https://ea-mcp-demo.qiyuanlabs.ai/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http easyappointments https://ea-mcp-demo.qiyuanlabs.ai/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add easyappointments --url https://ea-mcp-demo.qiyuanlabs.ai/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "easyappointments": {
            "url": "https://ea-mcp-demo.qiyuanlabs.ai/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "easyappointments": {
            "type": "http",
            "url": "https://ea-mcp-demo.qiyuanlabs.ai/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http easyappointments https://ea-mcp-demo.qiyuanlabs.ai/mcp
```

## When to use it
- find an available time with a provider
- look up a customer's bookings or appointments in a date range
- create a booking for a new or existing customer
- move an appointment to another time or provider
- cancel a future booking

## Example prompts
- Find open times for this service over the next two weeks.
- Show the bookings for the customer with this email address.
- Move this booking to a different time and request confirmation.

## Similar
- [Fresha by Cotlet](https://affpapa.org/en/nevibecode/mcp/fresha-by-cotlet.md) — MCP server · ★ 7 repo stars
- [ChairFlow](https://affpapa.org/en/nevibecode/mcp/chairflow.md) — MCP server · 235 installs
- [DaySchedule](https://affpapa.org/en/nevibecode/mcp/dayschedule.md) — MCP server
- [easy-predict](https://affpapa.org/en/nevibecode/mcp/easy-predict.md) — MCP server · 140 installs
- [make-pr-easy-to-review](https://affpapa.org/en/nevibecode/skills/make-pr-easy-to-review.md) — skill · 3400 installs
- [easy-cheese-setup](https://affpapa.org/en/nevibecode/skills/easy-cheese-setup.md) — skill · 651 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
