# BigTime MCP by usefulapi

> BigTime MCP by usefulapi is an MCP server. Read staff, projects, clients, time, expenses and invoices; create time entries in BigTime. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/bigtime/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/bigtime
- **MCP Registry name:** io.usefulapi/bigtime
- **Listing updated:** 2026-11-13

## About

Read staff, projects, clients, time, expenses and invoices; create time entries in BigTime.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `bigtime_list_staff`: List staff members (id = staff sid, name, email). Good first call. BigTime API: GET /staff.
- `bigtime_get_staff`: Get one staff member by staff sid. BigTime API: GET /staff/detail/{sid}.
- `bigtime_list_projects`: List projects (id, name, client, status). BigTime API: GET /project.
- `bigtime_get_project`: Get one project by sid, with budget, dates and billing setup. BigTime API: GET /project/detail/{sid}.
- `bigtime_get_project_team`: List the staff assigned to a project. BigTime API: GET /project/team/{sid}.
- `bigtime_list_clients`: List clients (id, name, client id). BigTime API: GET /client.
- `bigtime_get_client`: Get one client by sid. BigTime API: GET /client/detail/{sid}.
- `bigtime_list_project_tasks`: List the tasks of one project. BigTime API: GET /task/listByProject/{ProjectSid}.
- `bigtime_list_staff_tasks`: List the tasks assigned to one staff member. BigTime API: GET /task/ListByStaffer/{StaffSid}.
- `bigtime_get_task`: Get one task by sid. BigTime API: GET /task/detail/{TaskSid}.
- `bigtime_get_timesheet`: List the time entries of one staff member in a date range. BigTime API: GET /time/Sheet/{staffsid}.
- `bigtime_list_project_time`: List the time entries logged on one project in a date range. BigTime API: GET /time/ByProject/{Id}.
- `bigtime_get_time_entry`: Get one time entry by sid. BigTime API: GET /time/{sid}.
- `bigtime_get_daily_totals`: Get the hours per day for one staff member in a date range. BigTime API: GET /time/TotalByDay/{staffsid}.
- `bigtime_get_expense`: Get one expense entry by sid. BigTime API: GET /expense/detail/{sid}.
- `bigtime_list_expense_reports`: List expense reports. BigTime API: GET /expense/reports.
- `bigtime_list_invoices`: List issued invoices in a date range. BigTime API: GET /invoice/history.
- `bigtime_list_draft_invoices`: List draft invoices, optionally in a date range. BigTime API: GET /invoice/drafts.
- `bigtime_get_invoice`: Get one invoice by sid. BigTime API: GET /invoice/detail/{sid}.
- `bigtime_list_client_invoices`: List the invoices of one client in a date range. BigTime API: GET /invoice/GetInvoicesByClientId.
- `bigtime_list_payments`: List payments received in a date range. BigTime API: GET /payment/history.
- `bigtime_get_report_definition`: Get the definition (fields and filters) of a saved report. BigTime API: GET /report/detail/{id}.
- `bigtime_run_report`: Run a saved BigTime report and return its rows. Pass the report filters as a JSON object, for example {"DT_BEGIN":"2026-01-01","DT_END":"2026-01-31"}. Read only. BigTime API: POST /report/data/{id}.
- `bigtime_create_time_entry`: WRITE: log time for a staff member on a project. Creates a new time entry in BigTime (it does not replace one). Set mark_submitted to submit it for approval at once. BigTime API: POST /time.

## FAQ

### How do I add BigTime MCP by usefulapi to Claude Code?

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

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