Skip to content
MCP server

Teamdeck MCP by usefulapi

Read projects, bookings, time and vacations; create bookings, time entries and projects…

Install
Runs
Remotely
Version
1.7.0
Listing updated
5 days ago

About Teamdeck MCP by usefulapi

Teamdeck MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Read projects, bookings, time and vacations; create bookings, time entries and projects in Teamdeck.

Install

Run in a terminal

claude mcp add --transport http teamdeck https://teamdeck.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://teamdeck.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "teamdeck": {
      "url": "https://teamdeck.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "teamdeck": {
      "type": "http",
      "url": "https://teamdeck.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "teamdeck": {
      "serverUrl": "https://teamdeck.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "teamdeck": {
      "type": "http",
      "url": "https://teamdeck.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (16)

Read directly from the server.

teamdeck_get_organization
Return the Teamdeck organization: name, work week and settings. Also a cheap check that the key works.
teamdeck_list_projects
List projects in the organization. Filter by name or archived state.
teamdeck_get_project
Get one project by id.
teamdeck_list_resources
List resources (people) in the organization. By default only active resources return.
teamdeck_get_resource
Get one resource (person) by id.
teamdeck_list_bookings
List planned work (bookings): who is booked on which project, for how many minutes, between which dates. Use `date` for bookings that cover one day.
teamdeck_get_booking
Get one booking by id.
teamdeck_list_time_entries
List logged time (time entries): who worked on which project, minutes, dates and approval status.
teamdeck_get_time_entry
Get one time entry by id.
teamdeck_list_vacations
List leave (vacations and time off) with dates and status (0 requested, 1 accepted, 2 requested to be removed).
teamdeck_list_milestones
List project milestones, optionally for one project or a date range.
teamdeck_list_organization_units
List organization units (departments or teams).
teamdeck_list_project_tags
List project tags.
teamdeck_create_booking
WRITE: plan work for a resource on a project between two dates. Needs a read + write key. Each call creates a new booking; do not repeat a call that succeeded. Set `minutes` (per day).
teamdeck_create_time_entry
WRITE: log worked time for a resource on a project. Needs a read + write key. Each call creates a new time entry; do not repeat a call that succeeded.
teamdeck_create_project
WRITE: create a project. Needs a read + write key. Each call creates a new project.

Teamdeck MCP by usefulapi FAQ

How do I add Teamdeck MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http teamdeck https://teamdeck.usefulapi.io/mcp