BigTime MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.3.4Updated Nov 7, 2026

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

The publisher's own server: Ably MCP by usefulapi

Overview

AI-generated overview

Hosted BigTime connector that lets an assistant read staff, projects, clients, tasks, time, expenses, invoices and payments, run saved reports and log time…

What you can do
  • List and look up staff members, clients and projects, including project budgets, billing setup and assigned teams
  • List project tasks and staff tasks, and fetch a single task
  • Read timesheets, project time entries, single time entries and per-day hour totals
  • Read expense entries and expense reports
  • List issued and draft invoices, client invoices, payments and single invoices
  • Get saved report definitions and run saved reports with JSON filters
When to use it
Useful when you want to ask questions about BigTime project, time and billing data in plain language, such as hours logged per person, projects over budget, or draft invoices by client, and occasionally log time without opening BigTime.
Requirements
Remote MCP endpoint, no local install. Sign-in is via OAuth; on first connect you supply a BigTime API token and your BigTime firm id, which a firm administrator creates in BigTime. The server stores them per user. A free plan allows 50 tool calls per month; paid plans are available.
Before you install
The server holds your BigTime API token and firm id, so grant it only to a trusted host. bigtime_create_time_entry writes new time entries and can submit them for approval, so confirm before use. Paid plans involve payment through a checkout link, and cancelling does not refund the current period. Usage is metered per month.

Installation

In SourceWeft

  1. Open BigTime MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fbigtime/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

BigTime MCP by usefulapi

Use your BigTime account from Claude, Cursor, or any MCP client. Read staff, projects, clients, tasks, time, expenses, invoices and payments, run saved reports and create time entries. Hosted, no local install: connect with your own credentials.

Live endpoint: https://bigtime.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://bigtime.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http bigtime https://bigtime.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "bigtime": {      "url": "https://bigtime.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your BigTime credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/bigtime/

On first connect you provide a BigTime API token and your BigTime firm id (a firm administrator creates the token in BigTime). The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
bigtime_list_staffreadList staff
bigtime_get_staffreadGet a staff member
bigtime_list_projectsreadList projects
bigtime_get_projectreadGet a project
bigtime_get_project_teamreadGet a project team
bigtime_list_clientsreadList clients
bigtime_get_clientreadGet a client
bigtime_list_project_tasksreadList tasks of a project
bigtime_list_staff_tasksreadList tasks of a staff member
bigtime_get_taskreadGet a task
bigtime_get_timesheetreadGet a timesheet
bigtime_list_project_timereadList time entries of a project
bigtime_get_time_entryreadGet a time entry
bigtime_get_daily_totalsreadGet daily hour totals
bigtime_get_expensereadGet an expense entry
bigtime_list_expense_reportsreadList expense reports
bigtime_list_invoicesreadList invoice history
bigtime_list_draft_invoicesreadList draft invoices
bigtime_get_invoicereadGet an invoice
bigtime_list_client_invoicesreadList invoices of a client
bigtime_list_paymentsreadList payment history
bigtime_get_report_definitionreadGet a report definition
bigtime_run_reportreadRun a saved report
bigtime_create_time_entrywriteCreate a time entry
bigtime_usage_statusmetaUsage status (free-tier meter)
bigtime_request_featuremetaRequest a missing feature
bigtime_upgrademetaUpgrade to Pro or Pro+
bigtime_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with bigtime_upgrade (it returns a Stripe Checkout link). Cancel any time with bigtime_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running bigtime_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/bigtime/README.md at commit 4046075

Tools

24

bigtime_list_staff

List staff

List staff members (id = staff sid, name, email). Good first call. BigTime API: GET /staff.

Parametersshow_inactive

bigtime_get_staff

Get a staff member

Get one staff member by staff sid. BigTime API: GET /staff/detail/{sid}.

Parametersviewstaff_sidrequired

bigtime_list_projects

List projects

List projects (id, name, client, status). BigTime API: GET /project.

Parametersshow_inactive

bigtime_get_project

Get a project

Get one project by sid, with budget, dates and billing setup. BigTime API: GET /project/detail/{sid}.

Parametersviewproject_sidrequired

bigtime_get_project_team

Get a project team

List the staff assigned to a project. BigTime API: GET /project/team/{sid}.

Parametersproject_sidrequired

bigtime_list_clients

List clients

List clients (id, name, client id). BigTime API: GET /client.

Parametersshow_inactive

bigtime_get_client

Get a client

Get one client by sid. BigTime API: GET /client/detail/{sid}.

Parametersviewclient_sidrequired

bigtime_list_project_tasks

List tasks of a project

List the tasks of one project. BigTime API: GET /task/listByProject/{ProjectSid}.

Parametersproject_sidrequiredshow_completed

bigtime_list_staff_tasks

List tasks of a staff member

List the tasks assigned to one staff member. BigTime API: GET /task/ListByStaffer/{StaffSid}.

Parametersstaff_sidrequiredshow_completed

bigtime_get_task

Get a task

Get one task by sid. BigTime API: GET /task/detail/{TaskSid}.

Parametersviewtask_sidrequired

bigtime_get_timesheet

Get a timesheet

List the time entries of one staff member in a date range. BigTime API: GET /time/Sheet/{staffsid}.

Parametersviewend_daterequiredstaff_sidrequiredstart_daterequired

bigtime_list_project_time

List time entries of a project

List the time entries logged on one project in a date range. BigTime API: GET /time/ByProject/{Id}.

Parametersviewend_daterequiredstart_daterequiredis_approvedproject_sidrequired

bigtime_get_time_entry

Get a time entry

Get one time entry by sid. BigTime API: GET /time/{sid}.

Parameterstime_sidrequired

bigtime_get_daily_totals

Get daily hour totals

Get the hours per day for one staff member in a date range. BigTime API: GET /time/TotalByDay/{staffsid}.

Parametersend_daterequiredstaff_sidrequiredstart_daterequired

bigtime_get_expense

Get an expense entry

Get one expense entry by sid. BigTime API: GET /expense/detail/{sid}.

Parametersexpense_sidrequired

bigtime_list_expense_reports

List expense reports

List expense reports. BigTime API: GET /expense/reports.

Parametersshow_all

bigtime_list_invoices

List invoice history

List issued invoices in a date range. BigTime API: GET /invoice/history.

Parametersend_daterequiredstart_daterequired

bigtime_list_draft_invoices

List draft invoices

List draft invoices, optionally in a date range. BigTime API: GET /invoice/drafts.

Parametersend_datestart_date

bigtime_get_invoice

Get an invoice

Get one invoice by sid. BigTime API: GET /invoice/detail/{sid}.

Parametersinvoice_sidrequired

bigtime_list_client_invoices

List invoices of a client

List the invoices of one client in a date range. BigTime API: GET /invoice/GetInvoicesByClientId.

Parametersend_dateclient_sidrequiredstart_date

bigtime_list_payments

List payment history

List payments received in a date range. BigTime API: GET /payment/history.

Parametersend_daterequiredstart_daterequired

bigtime_get_report_definition

Get a report definition

Get the definition (fields and filters) of a saved report. BigTime API: GET /report/detail/{id}.

Parametersreport_idrequired

bigtime_run_report

Run a saved 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}.

Parametersfiltersreport_idrequired

bigtime_create_time_entry

Create a 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.

Parametersdaterequiredhoursrequirednotestask_sidstaff_sidrequiredproject_sidrequiredmark_submitted

Version history

6
  1. v1.3.4LatestNov 7, 2026
  2. v1.2.3Nov 5, 2026
  3. v1.2.2Nov 5, 2026
  4. v1.2.1Nov 4, 2026
  5. v1.2.0Nov 3, 2026
  6. v1.1.1Nov 3, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations