# Teamdeck MCP by usefulapi

> Teamdeck MCP by usefulapi is a freemium MCP server for productivity. Hosted MCP server connecting Teamdeck projects, bookings and time entries to AI clients. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web
- **Website:** https://usefulapi.io/teamdeck/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/teamdeck
- **MCP Registry name:** io.usefulapi/teamdeck
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

The server gives an AI assistant access to a Teamdeck account so you can check who is booked on which project, review logged time, look up leave, and create bookings, time entries or projects through plain-language requests. The README describes it as hosted, so there is nothing to install locally; you add its URL to a client and sign in with a Teamdeck API key.

Access is split into 13 read-only tools and 3 tools that write data. A read-only API key limits the connection to lookups, while a read and write key also allows creating records. The README notes that most clients ask for approval before a write runs. Usage is metered per month on the free tier, and the server also exposes tools to check usage and manage a paid subscription.

The server suits agencies and teams that plan resources and track time in Teamdeck and want to query that data from Claude, ChatGPT, Cursor or another MCP-compatible client. usefulapi states it is an independent service, not affiliated with Teamdeck.

## Features

- **Read planning data:** Lists projects, resources, bookings, time entries, vacations, milestones and organization units from a Teamdeck account.
- **Create bookings and time:** Adds a booking for a person on a project over a date range, or logs a time entry, using a read and write key.
- **Create projects:** Opens a new project in Teamdeck from the AI client.
- **OAuth sign-in:** Users authenticate through a login page with their Teamdeck API key rather than storing keys in client config files.
- **Usage metering:** Includes tools to report monthly tool-call usage and to upgrade or cancel a paid plan.

## Good for

- Check who is booked on a project during a given week
- Find team members on vacation before planning new work
- Review the logged time of one person across projects
- Book a resource on a project for a set number of hours per day
- Open a new project record without leaving the AI chat

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://teamdeck.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "teamdeck": {
      "url": "https://teamdeck.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## FAQ

### Is this an official Teamdeck product?

No. The site states usefulapi is an independent service and is not affiliated with or endorsed by Teamdeck.

### Do I need to put my API key in the client config?

No. The site says to add only the URL; the server signs you in through a login page that asks for your Teamdeck API key.

### Can the AI change data in my Teamdeck account?

Yes, through three write tools that create bookings, time entries or projects. The other 13 tools are read-only.

### What does it cost?

The Free plan allows 50 tool calls a month. Pro is listed at $9 per month or $90 per year with 10,000 calls, and Pro+ at $39 per month or $390 per year with 100,000 calls. Each subscription covers this server only.

### Is Teamdeck MCP by usefulapi free?

Teamdeck MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### 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

### What are the best alternatives to Teamdeck MCP by usefulapi?

The closest alternatives to Teamdeck MCP by usefulapi are Ha MCP, Concord MCP, note1, InviteKit Calendar Files and Google Workspace MCP.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 13 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [InviteKit Calendar Files](https://ai-powered.com/mcp/invitekit-calendar-files): InviteKit Calendar Files is an MCP server for files and documents.
- [Google Workspace MCP](https://ai-powered.com/mcp/google-workspace-mcp-2): Google Workspace MCP is an MCP server for productivity.
- [Google_calendar](https://ai-powered.com/mcp/google-calendar-3): Google_calendar is a freemium MCP server for productivity.
- [Zovo Org Chart Maker](https://ai-powered.com/mcp/zovo-org-chart-maker): Zovo Org Chart Maker is an MCP server for productivity.
- [Notion_connect](https://ai-powered.com/mcp/notion-connect): Notion_connect is a freemium MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/teamdeck-mcp-by-usefulapi
