# TeamGantt MCP by usefulapi

> TeamGantt MCP by usefulapi is a freemium MCP server for productivity. Hosted MCP server connecting TeamGantt schedules, tasks and workload 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, vscode, CLI
- **Website:** https://usefulapi.io/teamgantt/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/teamgantt
- **MCP Registry name:** io.usefulapi/teamgantt
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

The README and website describe a hosted connector that lets an AI assistant read TeamGantt project schedules, tasks, timesheets and team workload, and add tasks or comments. Nothing is installed locally; you sign in once with your own TeamGantt API app credentials, which the server uses to call TeamGantt on your behalf.

The server exposes 18 tools in total. Twelve are read-only and cover projects, groups, tasks, comments, resources and workload. Two write tools create tasks and comments, and the rest handle usage status, feature requests and subscription management. Most clients ask for approval before a write runs.

It suits project managers who plan in TeamGantt Gantt charts and want to query overdue work or capacity from Claude, ChatGPT, Cursor or VS Code. The service is run by usefulapi, which states it is independent and not affiliated with TeamGantt.

## Features

- **Project schedule reading:** Retrieves groups, subgroups and tasks of a project with dates and percent complete.
- **Task search and filters:** Lists or searches tasks by name, date range, overdue status, assignment or resource.
- **Team workload view:** Shows scheduled work per person or resource grouped by day, week, month or year.
- **Timesheet access:** Reads the signed-in user's tracked and estimated hours per day in a date range.
- **Task and comment creation:** Adds new tasks to a project group and posts comments or notes on projects, groups or tasks.
- **OAuth sign-in:** Uses a login page for your TeamGantt app client id, client secret and refresh token, with no API key in client configs.

## Good for

- Find tasks that are overdue in active projects this week
- Check how loaded each team member is over the coming month
- Add a task with dates to a project from inside an AI chat
- Post a status update comment on a task

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `teamgantt_get_current_user`: Get the signed-in TeamGantt user: name, email, time zone, today's date and the companies (accounts) the user belongs to. Call this first to find company ids. TeamGantt API: GET /current_user.
- `teamgantt_list_projects`: List the projects the user can see, pre-sorted starred first then by name. Default is Active projects, 100 per page. TeamGantt API: GET /projects.
- `teamgantt_get_project`: Get one project: dates, status, chart days, permission, members (accesses) and teams. TeamGantt API: GET /projects/{project_id}.
- `teamgantt_get_project_schedule`: Get the full schedule of a project: groups, subgroups and tasks (with dates, percent complete, assignments). Use is_flat_list for one flat array. TeamGantt API: GET /projects/{project_id}/children.
- `teamgantt_list_groups`: List the groups and subgroups of one or more projects (useful to find a parent_group_id for a new task). TeamGantt API: GET /groups.
- `teamgantt_list_tasks`: List tasks across projects, with filters: project, name search, date range, overdue, unassigned, resource. Active projects by default. To see one person's tasks for a day, pass user_resource_ids and the same start_date and end_date. TeamGantt API: GET /tasks.
- `teamgantt_get_task`: Get one task or milestone: dates, days, percent complete, estimated hours, assigned resources, dependencies and comment counts. TeamGantt API: GET /tasks/{id}.
- `teamgantt_list_comments`: List the comments and notes on a project, a group or a task. TeamGantt API: GET /{target}/{target_id}/comments.
- `teamgantt_list_company_users`: List the users of a company (account): names, emails, roles. Needs account holder or manager access. TeamGantt API: GET /companies/{company_id}/users.
- `teamgantt_list_resources`: List all resources of a company, split by type (company resources, project resources, users). Resources are the labels used to schedule tasks. TeamGantt API: GET /companies/{company_id}/resources/all.
- `teamgantt_get_timesheets`: Get the signed-in user's timesheet: tasks with tracked and estimated hours per day in a date range. TeamGantt API: GET /timesheets.
- `teamgantt_get_workload`: See how busy people or resources are: scheduled work grouped by day, week, month or year. TeamGantt API: GET /workload/{resource_type}.
- `teamgantt_create_task`: WRITE: create a new task or milestone in a project. It changes the customer's schedule and is not repeated automatically. Without parent_group_id the task goes in the last group. TeamGantt API: POST /tasks.
- `teamgantt_create_comment`: WRITE: add a comment or a note to a project, group or task. People who are @mentioned may get an email. It is not repeated automatically. TeamGantt API: POST /{target}/{target_id}/comments.

## FAQ

### Is this an official TeamGantt product?

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

### What credentials do I need to connect?

A TeamGantt app client id, client secret and refresh token. The website explains how to create them via Configure API Access in TeamGantt.

### Can the AI change my TeamGantt data?

Yes, through two write tools that create tasks and comments. The other 12 data tools are read-only, and most clients ask for approval before a tool call runs.

### What does it cost?

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

### Is TeamGantt MCP by usefulapi free?

TeamGantt 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 TeamGantt MCP by usefulapi to Claude Code?

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

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

The closest alternatives to TeamGantt 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/teamgantt-mcp-by-usefulapi
