# TimeTap MCP by usefulapi

> TimeTap MCP by usefulapi is a freemium MCP server for productivity. Read-only MCP connector for TimeTap appointments, staff, locations and services. 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/timetap/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/timetap
- **MCP Registry name:** io.usefulapi/timetap
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

The README and product page describe a hosted endpoint that lets an AI assistant read scheduling data from a TimeTap Business or Enterprise account. Staff, locations, services and appointment schedules can be reviewed in plain language, with the assistant choosing which of the 13 tools to call.

Sign-in happens through OAuth: the login page asks for a TimeTap API key and private key rather than a header in the client config. Nine tools are read-only, covering business details, staff, locations, services and appointment lists. The other four handle usage status, feature requests and subscription management. Client identities, contact details, appointment notes and payment settings are documented as excluded from responses.

The server suits scheduling teams on TimeTap who want to query their calendar from Claude, ChatGPT, Cursor or another MCP client. It is an independent integration by usefulapi and is not endorsed by TimeTap.

## Features

- **Read-only scheduling access:** All nine data tools are marked read-only, so the assistant can review but not change TimeTap records.
- **Appointment schedule review:** Lists appointments over a date range of up to 93 days, filterable by staff, location or service, with paging.
- **Staff, location and service lookup:** Retrieves scheduling staff, locations and bookable services with IDs, durations and pricing.
- **OAuth sign-in:** Clients connect by URL alone; the login page collects TimeTap API and private keys.
- **Usage metering:** A free tier of 50 tool calls per month, with paid Pro and Pro+ plans for higher volume.

## Good for

- Reviewing next week's appointment schedule by location and staff
- Comparing service durations and prices across staff members or locations
- Checking the status and time of a specific appointment
- Listing which staff accept bookings at a given location

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `timetap_get_business`: Read the authenticated business ID, name and selected scheduling settings. Excludes billing tokens and payment configuration.
- `timetap_list_staff`: GET /staff. Read staff IDs, names and scheduling flags. No contact details, user logins or profiles. Vendor route is unpaginated, bounded here to 5,000 rows/2 MiB. locationId values are sent comma-separated as documented.
- `timetap_list_locations`: Read one page of scheduling locations. Continue pageNumber while the returned page is full; vendor provides no total on this route. Excludes private scheduling links, embed codes, email and tax IDs.
- `timetap_list_services`: GET /services. Read service/reason IDs, names, duration and pricing; private PERSONAL reasons are excluded via includePersonal=0. Vendor route is unpaginated, bounded to 5,000 rows/2 MiB. Results reflect the credential's permissions and scheduling filters.
- `timetap_get_staff`: Read one scheduling staff member by its numeric professionalId. Selected scheduling fields only; clients, notes, form answers, private URLs and other unselected fields are omitted.
- `timetap_get_location`: Read one scheduling location by its numeric locationId. Selected scheduling fields only; clients, notes, form answers, private URLs and other unselected fields are omitted.
- `timetap_get_service`: Read one service by its numeric reasonId. Selected scheduling fields only; clients, notes, form answers, private URLs and other unselected fields are omitted.
- `timetap_get_appointment`: Read one appointment by its numeric calendarId. Selected scheduling fields only; clients, notes, form answers, private URLs and other unselected fields are omitted.
- `timetap_list_appointments`: Read one page from GET /appointmentList/reportWithCount using an ordered YYYY-MM-DD date range (up to 93 days). Client records/contact, subject/notes, forms/custom fields, payment and appointment management links are omitted. PERSONAL time-off is excluded. Local wall-clock numbers are TimeTap HHmm values, not decimal hours; UTC epoch fields are milliseconds. Count is the vendor total; request the 

## FAQ

### What do I need to connect?

The login page asks for your TimeTap API key and TimeTap private key. The product page says these come from Settings → Integrations → API Key on a TimeTap Business or Enterprise account with API access enabled.

### Is this an official TimeTap product?

No. usefulapi is an independent service and is not affiliated with or endorsed by TimeTap.

### Can the AI change my TimeTap data?

All 9 TimeTap data tools are marked read-only, according to the product page.

### What does it cost?

The Free plan includes 50 tool calls per month. Pro is $9/mo or $90/yr with 10,000 calls per month. Pro+ is $39/mo or $390/yr with 100,000 calls per month.

### Is TimeTap MCP by usefulapi free?

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

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

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

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