Skip to content
MCP server

BigTime MCP by usefulapi

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

Install
Runs
Remotely
Version
1.7.0
Listing updated
4 days ago

About BigTime MCP by usefulapi

BigTime MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

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

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://bigtime.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "bigtime": {
      "url": "https://bigtime.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (24)

Read directly from the server.

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.

BigTime MCP by usefulapi 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