---
name: favcrm-booking
description: Connect an AI assistant to FavCRM and safely read or manage bookings and customer profiles. Use when a merchant asks to find availability, inspect bookings, or perform booking operations through FavCRM MCP.
---

# FavCRM booking operations

## Connect and verify

1. Reuse an existing connection only after confirming the merchant workspace and access. Otherwise follow the [FavCRM booking MCP guide](https://favcrm.io/docs/simply-booking-mcp.md).
2. Use `https://api.favcrm.io/mcp/oauth/view` for strictly read-only access, or `https://api.favcrm.io/mcp/oauth/manage` when booking changes may be needed. The manage resource sets a permission ceiling; the merchant can grant fewer scopes.
3. Let an authorized merchant sign in and approve access in their browser. Never request passwords, one-time codes, API keys, access tokens, or authorization codes in chat.
4. Inspect `tools/list` and perform an authorized read. Report the workspace and granted permissions only when verified. Available tools also depend on the merchant's plan and membership permissions.

## Work with bookings

- Check the workspace timezone and look up the relevant booking or availability before acting. Distinguish an empty result from an error.
- Check pagination or result totals; narrow a date range when a result is incomplete. Do not claim a partial list is complete.
- Before creating, changing, or cancelling a booking, confirm the intended operation with the merchant. A cancellation can initiate a refund; follow the server's response and merchant review instructions.
- Treat an approval request or pending refund as pending, not as a completed cancellation or refund. Do not issue a second refund for a cancellation that already processes one.
- Use the schemas returned by `tools/list`. Do not assume access to other CRM operations or attempt to bypass a missing permission.

The [booking MCP guide](https://favcrm.io/docs/simply-booking-mcp.md) covers host setup, connection-key restrictions, scope discovery, and revocation.
