# Timicx MCP by usefulapi

> Timicx MCP by usefulapi is a freemium MCP server for time tracking. Hosted MCP server to book, edit and run timers in Timicx from an AI assistant. 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, CLI, vscode
- **Website:** https://usefulapi.io/timicx/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/timicx
- **MCP Registry name:** io.usefulapi/timicx
- **Categories:** time tracking
- **Listing updated:** 2026-11-18

## About

The server connects an AI client such as Claude, ChatGPT or Cursor to a Timicx account, so time can be booked and timers controlled through ordinary chat requests. It is hosted by usefulapi, so there is nothing to install locally; the user signs in once through a login page using their Timicx subdomain, user name and password.

The server exposes 20 tools. Nine are read-only and cover time bookings, live timers, employees, projects and tasks. Seven can create, change, pause, resume, finish or delete time, and the README notes that clients should ask for confirmation before running them. The remaining four handle usage status, feature requests and subscription management.

It suits teams that already track project hours in Timicx and want to log work or check who is timing what without leaving their AI tool. The README states that usefulapi is an independent service and is not affiliated with Timicx.

## Features

- **Time booking:** Creates finished time entries with a date, task, duration in seconds and optional comment.
- **Live timers:** Starts, pauses, resumes and finishes a running timer for the logged-in employee.
- **Booking review:** Lists time bookings by date range, employee, project, task or status.
- **Read-only lookups:** Retrieves employees, projects, tasks and running timers without changing data.
- **Booking corrections:** Updates only the fields provided on an existing entry, or deletes it permanently.
- **Per-user login:** Uses OAuth with Timicx credentials stored encrypted, with no API key in client config.

## Good for

- Logging a finished work session against a project and task from a chat
- Checking which projects a team booked hours on during a given week
- Seeing who currently has a timer running and on which task
- Correcting or removing a wrong time booking after reviewing it

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `timicx_list_time_entries`: List time bookings with date, employee, project, task, duration, status and billable flag.
- `timicx_get_time_entry`: Get one time booking by id.
- `timicx_list_running_timers`: List live timers that are running or paused.
- `timicx_list_employees`: List employees of the Timicx system.
- `timicx_get_employee`: Get one employee by id.
- `timicx_list_projects`: List projects with name, description, active flag and parent.
- `timicx_get_project`: Get one project by id.
- `timicx_list_tasks`: List tasks that time can be booked on.
- `timicx_get_task`: Get one task by id.
- `timicx_create_time_entry`: Create a finished time entry.
- `timicx_update_time_entry`: Change fields of a time entry.
- `timicx_start_timer`: Start a live timer.
- `timicx_pause_timer`: Pause a running live timer.
- `timicx_resume_timer`: Resume a paused live timer.
- `timicx_finish_timer`: Finish a live timer and keep its time as a booking.
- `timicx_delete_time_entry`: Delete a time booking; this cannot be undone.
- `timicx_usage_status`: Report current usage against the plan limit.
- `timicx_request_feature`: Send a request for a feature the tools cannot yet do.
- `timicx_upgrade`: Get a paid plan link for Pro or Pro+.
- `timicx_cancel_subscription`: Cancel the Pro subscription at the end of the paid period.

## FAQ

### Is this an official Timicx product?

No. The README and website say usefulapi is an independent service and is not affiliated with or endorsed by Timicx.

### Do I need to install anything locally?

No. The server is hosted at a remote Streamable HTTP endpoint, and clients connect to it by URL.

### Can the AI change my Timicx data?

Yes, through 7 write tools, which the website says most MCP clients ask you to approve before they run.

### What does it cost?

The Free plan allows 50 tool calls a month. Pro is $9/month or $90/year with 10,000 calls, and Pro+ is $39/month or $390/year with 100,000 calls.

### Is Timicx MCP by usefulapi free?

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

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

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

The closest alternatives to Timicx MCP by usefulapi are TotemClock MCP by usefulapi, TimeStation MCP by usefulapi, ROLLER MCP by usefulapi, Staffwise MCP by usefulapi and TimeTrex MCP by usefulapi.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [TotemClock MCP by usefulapi](https://ai-powered.com/mcp/totemclock-mcp-by-usefulapi): TotemClock MCP by usefulapi is a freemium MCP server for hiring and recruiting.
- [TimeStation MCP by usefulapi](https://ai-powered.com/mcp/timestation-mcp-by-usefulapi): TimeStation MCP by usefulapi is a freemium MCP server for hr and payroll.
- [ROLLER MCP by usefulapi](https://ai-powered.com/mcp/roller-mcp-by-usefulapi): ROLLER MCP by usefulapi is a freemium MCP server for time tracking.
- [Staffwise MCP by usefulapi](https://ai-powered.com/mcp/staffwise-mcp-by-usefulapi): Staffwise MCP by usefulapi is a freemium MCP server for time tracking.
- [TimeTrex MCP by usefulapi](https://ai-powered.com/mcp/timetrex-mcp-by-usefulapi): TimeTrex MCP by usefulapi is a freemium MCP server for time tracking.
- [Zaui MCP by usefulapi](https://ai-powered.com/mcp/zaui-mcp-by-usefulapi): Zaui MCP by usefulapi is a freemium MCP server for time tracking.
- [Timetaag MCP by usefulapi](https://ai-powered.com/mcp/timetaag-mcp-by-usefulapi): Timetaag MCP by usefulapi is a freemium MCP server for hr and payroll.
- [Paydirt MCP by usefulapi](https://ai-powered.com/mcp/paydirt-mcp-by-usefulapi): Paydirt MCP by usefulapi is a freemium MCP server for time tracking.

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