Book people onto a Resource Guru project with AI

1. In the Schedule, click and drag across the days to book, or click one day and edit the dates.
2. In the booking form, pick the Person or Placeholder, add more people for a multi-resource booking, and choose Hours Per Day, Total Hours or Specific Time.
3. Choose the Project or Client, an Activity Type, the Billable toggle and Details, then click Add Booking.
4. If the person has too little free time, the form shows a Booking Clash with three options: Add to Waiting List, Add With Overtime, or Add without overtime (extend availability).
5. Each request repeats the same form, and a clash on one person is easy to miss in a multi-resource booking.

Book Lena Ortiz and Sam Okafor on Website Redesign for Acme from 2 to 6 November, 4 hours a day. Check their bookings first and tell me who is already full.

1. 01

   Resolve the names

   Your agent matches the people in your request to IDs with list_resources, and the project with list_projects. A name that matches two entries stops the run and the agent asks which one you mean.

2. 02

   Look before booking

   list_bookings runs for those people over the date range, so the agent sees how full each day already is. Someone who is booked all day is reported to you before any booking is made.

3. 03

   Create one multi-resource booking

   create_booking books all people in one call, with minutes_per_day, the project and your Details text. Tentative stays off unless you asked for a pencil booking.

4. 04

   Handle clashes your way

   If you did not say what to do about a clash, the agent leaves clash_resolution unset and reports the clash. If you said "put the overflow on the waiting list", it passes add_to_waiting_list.

5. 05

   Report what was booked

   The agent returns the booking ID, the people, the days and any hours that went to the waiting list. Each call waits for your OK by default because the booked people see it on their Dashboard.

Booked Website Redesign (Acme), 2 to 6 Nov, 4h a day
Lena Ortiz: 5 days booked
Sam Okafor: 5 days booked
Booking ID 48213021
No clashes, nothing on the waiting list

curl -X POST https://cotlet.dev/api/v1/resource-guru/bookings \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"resource_ids":[18211,18214],"start_date":"2026-11-02","end_date":"2026-11-06","minutes_per_day":240,"project_id":703110,"details":"Acme redesign, homepage sprint"}'

{
  "id": 48213021,
  "resource_ids": [
    18211,
    18214
  ],
  "start_date": "2026-11-02",
  "end_date": "2026-11-06",
  "minutes_per_day": 240,
  "project_id": 703110,
  "tentative": false,
  "approval_state": "approved",
  "waiting": false
}

MCP: add https://cotlet.dev/mcp/v1 with the same key; the call is resource_guru_write → create_booking. Example data.

• Confirm or delete tentative Resource Guru bookings
• Approve or decline Resource Guru booking requests
• Resource Guru API and MCP server: every tool
• All use cases