Integration · Projects & tasks

Connect Claude & ChatGPT to Teambook

Ask your AI who is free next week, what a project has booked, or to plan three days of work for someone in Teambook. It can read and plan bookings, log actual hours, and check capacity per person and per project. It can also create and update projects, clients, tasks and users.

Connect Teambook free

Free plan, no credit card. Takes about a minute.

Try asking

“Who has free capacity next week?”
The AI reads users' available capacity from that date and lists who has room.
“Book Anna on the Website project for 6 hours a day, Monday to Wednesday.”
It finds Anna, her team and the project, and plans three bookings of 360 minutes each.
“Log 3 hours on the Acme rebrand for me today.”
It creates a time log for today on that project with a duration of 180 minutes.

What your AI can do

Bookings and planning

List, plan, change and remove bookings by person, team or project, and see capacity per user and per project.

Time logs

List actual hours worked, log new time and adjust a log's date, duration, project, task, comment or approval.

Projects, clients and people

Read, create and update projects, clients, tasks and users, and look up teams.

“What is booked on the Mobile app project this month?”
It lists the bookings for the project over the period, with who is booked and for how long.
“Move Peter's Thursday booking to Friday.”
It finds the booking and changes its date. The duration and project stay the same.
“Create a client called Nordic Foods and a billable project for them.”
It creates the client, then a billable project linked to that client.

26 tools for Teambook

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

create_bookingsChanges dataPlan one or more bookings. Pass `bookings` as a list; each needs project_id, user_id, team_id, date (YYYY-MM-DD) and duration in minutes, and may include task_id, comment and start_time.
create_clientChanges dataCreate a client with a `name` and optional email and phone number.
create_projectChanges dataCreate a project with a `name`; optional code, kind (billable or non_billable), client, manager, start/end dates, estimate, colour and notes.
create_taskChanges dataCreate a task with a `name`, optionally limited to one `project_id`.
create_time_logsChanges dataLog actual time worked. Pass `actual_logs` as a list; each needs project_id, user_id, date (YYYY-MM-DD) and duration in minutes, and may include task_id and comment.
create_userChanges dataAdd a new user with `first_name`, `last_name`, `email` and `role` (regular, planner, contractor or self_planner); optional team IDs, phone and billable flag.
delete_bookingDeletesPermanently remove a booking by `booking_id`.
get_bookingGet one booking by `booking_id`.
get_clientGet one client by `customer_id`.
get_projectGet one project by `project_id`.
get_teamGet one team by `team_id`.
get_userGet one user by `user_id`.
list_bookingsList planned bookings, filtered by `user_id`, `team_id`, `project_id`, a start date `since` and a `range` of days. Paginated with `page`.
list_clientsList all clients.
list_project_capacitiesList planned capacity per project, filtered by `project_id` and a start date `since`.
list_projectsList all projects with their IDs.
list_tasksList all tasks (activity types that can be attached to bookings and time logs).
list_teamsList all teams with their IDs.
list_time_logsList actual time logs (hours worked), filtered by `user_id`, `project_id`, a start date `since` and a `range` of days.
list_user_capacitiesList users' available capacity, filtered by `user_id` and a start date `since`.
list_usersList all users (team members) in Teambook with their IDs.
update_bookingChanges dataChange a booking's date, duration (minutes), start time (e.g. 1423 for 14:23), user, project, task, comment or tentative flag by `booking_id`.
update_clientChanges dataUpdate a client's name, email or phone number by `customer_id`.
update_projectChanges dataUpdate a project's details (name, dates, client, manager, estimate, active flag, notes) by `project_id`. Only the fields you pass change.
update_time_logChanges dataChange a time log's date, duration, project, task, comment or approval by `actual_log_id`.
update_userChanges dataUpdate a user's name, email, role, phone, language, time zone, billable flag or schedule by `user_id`. Only the fields you pass change.

Set up in three steps

1
Pick the app
Create a free PipMCP account and choose Teambook from the app list.
2
Paste your key
Paste your Teambook API token. In Teambook click your name (top right) > Organization settings > Integration tab and generate the API token. Only Admins can do this.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Teambook?

The AI can read users, teams, clients, projects, tasks, bookings, time logs and capacity. It can create and update users, clients, projects, bookings and time logs, create tasks, and delete a booking if you switch that tool on.

Does the AI see my Teambook API token?

No. Your Teambook API token is encrypted at rest and never shown to the AI. After you save it, it is not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start read-only. Deleting a booking is permanent, and changing users or approving time logs affects the whole team, so those actions can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your PipMCP link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

PipMCP has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Teambook account.

What is the difference between bookings and time logs?

Bookings are planned work: who works on which project, on which day and for how many minutes. Time logs are the hours actually worked. The AI can work with both, so you can compare what was planned with what was logged.