1. MCP server
Public API
  • Welcome to the deskbird developer docs
  • Public API
    • Overview
    • Users
      • Lists company users
      • Retrieves a single company user
    • Bookings
      • Lists company bookings
      • Creates a new resource booking
      • Gets a single company booking
      • Updates an existing booking
      • Cancels a booking
      • Checks in to a booking
      • Releases a booking early
    • Groups
      • Lists company user groups
      • Retrieves a single company user group
    • Resources
      • Gets a resource by ID
      • Lists company resources
    • Offices
      • Lists company offices
      • Checks a user into an office
    • Scheduling
      • Lists company scheduling statuses
      • Deletes scheduling statuses by IDs
      • Adds new scheduling statuses for a user
    • Scheduling Options
      • Lists company scheduling options
    • Rooms
      • Lists company rooms
      • Gets a single room
      • Lists room bookings
      • Creates a room booking
      • Gets a single room booking
      • Updates a room booking
      • Checks in to a room booking
      • Cancels a room booking
      • Lists company room bookings
    • Floors
      • Lists company floors
    • Zones
      • Lists company zones
    • Tickets
      • Updates a ticket
    • Sensors
      • Lists company monitors
  • MCP server
    • Overview
    • Authentication
    • Tools reference
  • Schemas
    • Provider
    • UserStatus
    • UserIncludeOptions
    • BookingStatus
    • GuestEmbeddedResponse
    • UserEmbeddedResponse
    • ResourceEmbeddedResponse
    • BookingHistoryResponse
    • BookingResponse
    • PaginatedBookingResponse
    • CreateBookingGuestDto
    • CreateBookingDto
    • UpdateBookingDto
    • CheckInDto
    • AddressResponse
    • OpeningHourResponse
    • OpeningHoursResponse
    • OfficeResponse
    • EnvelopedOfficeResponse
    • CheckUserIntoOfficeBody
    • SharedResourceAccessInfoResponse
    • DedicatedResourceAccessInfoResponse
    • EquipmentResponse
    • ResourceResponse
    • ResourceType
    • PaginatedResourceResponse
    • SchedulingOutput
    • UserStatusInput
    • AddUserStatusesInput
    • SchedulingOptionOutput
    • AttendeeResponse
    • RoomBookingResponse
    • PaginatedRoomBookingResponse
    • RoomBookingDetailedResponse
    • AttendeeDto
    • RoomResponse
    • PaginatedRoomResponse
    • CreateRoomBookingDto
    • UpdateRoomBookingDto
    • FloorResponse
    • PaginatedFloorResponse
    • AssignedGroupResponse
    • ZoneResponse
    • PaginatedZoneResponse
    • UpdateTicketDto
    • MonitorState
    • MonitorOfficeResponse
    • MonitorFloorResponse
    • MonitorAreaResponse
    • MonitorDeskResponse
    • MonitorMappingResponse
    • MonitorResponse
    • PaginatedMonitorResponse
  1. MCP server

Overview

Connect AI assistants to your deskbird workspace. The deskbird MCP server implements the Model Context Protocol (MCP), an open standard that lets AI assistants like Claude query your workplace data through a set of controlled, read-only tools.
Ask questions like "how was desk utilization in the Berlin office last month?" or "which users never checked in this quarter?" and the assistant answers from your live deskbird data.

What you can do#

The server exposes 4 read-only tools:
ToolPurpose
users_listList and filter the users in your company
query_analyticsRun flexible analytics queries over bookings, scheduling, and utilization data
get_resource_hierarchyBrowse offices, floors, and zones, with occupancy stats
get_deskbird_docsFetch the analytics schema docs the assistant needs to query correctly
No tool can create, change, or delete anything in deskbird. See the tools reference page for parameters and details.

Requirements#

You are a company admin in deskbird.
Your company is on a plan that includes the MCP server feature (Desks Professional or Enterprise).
The MCP server is being rolled out gradually. If your company does not have access yet, contact your deskbird account manager.

Endpoint#

Server URLhttps://connect.deskbird.com/mcp
TransportStreamable HTTP (POST only, stateless)
AuthenticationOAuth 2.1 with PKCE
Companies hosted in the deskbird US environment use https://connect.us.deskbird.com/mcp.

Connect from Claude#

1.
In Claude, open Settings → Connectors → Add custom connector.
2.
Enter the server URL: https://connect.deskbird.com/mcp.
3.
Click Connect. You are redirected to deskbird to log in with your deskbird account.
4.
Review the consent screen and approve the connection.
That's it. Claude can now use the deskbird tools in your conversations. Currently, Claude (web, desktop, mobile, and Claude Code) is the supported client. Support for other MCP clients is planned.

Data access and security#

Company-scoped: every request is scoped to your own company on the server side. Tools cannot read data from other companies, and the scope cannot be widened by a tool argument.
Admin-only: only company admins can authorize a connection. The tokens carry the admin role requirement, and it is re-checked on every request.
Read-only: all tools only read data.
Revocable: disconnect the connector in Claude at any time. Sessions also expire on their own (see the authentication page).

Support#

Questions or issues? Contact support@deskbird.com.
Previous
MCP server
Next
Authentication
Built with