BigTime MCP by usefulapi is an MCP server published by io.usefulapi, hosted at bigtime.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 24 tools, including bigtime_list_staff, bigtime_get_staff, bigtime_list_projects, bigtime_get_project, bigtime_get_project_team.
Read staff, projects, clients, time, expenses and invoices; create time entries in BigTime.
4,138 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
List staff members (id = staff sid, name, email). Good first call. BigTime API: GET /staff.
| Parameter | Type | Description |
|---|---|---|
| show_inactive | boolean | Include inactive records (default false). |
{
"name": "bigtime_list_staff",
"title": "List staff",
"description": "List staff members (id = staff sid, name, email). Good first call. BigTime API: GET /staff.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"show_inactive": {
"type": "boolean",
"description": "Include inactive records (default false)."
}
}
},
"annotations": {
"title": "List staff",
"readOnlyHint": true
}
}Get one staff member by staff sid. BigTime API: GET /staff/detail/{sid}.
| Parameter | Type | Description |
|---|---|---|
| view | string | Detail level (default Basic). |
| staff_sid * | integer | Staff sid (from bigtime_list_staff). |
{
"name": "bigtime_get_staff",
"title": "Get a staff member",
"description": "Get one staff member by staff sid. BigTime API: GET /staff/detail/{sid}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"staff_sid"
],
"properties": {
"view": {
"enum": [
"Basic",
"Detailed"
],
"type": "string",
"description": "Detail level (default Basic)."
},
"staff_sid": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Staff sid (from bigtime_list_staff).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a staff member",
"readOnlyHint": true
}
}List projects (id, name, client, status). BigTime API: GET /project.
| Parameter | Type | Description |
|---|---|---|
| show_inactive | boolean | Include inactive records (default false). |
{
"name": "bigtime_list_projects",
"title": "List projects",
"description": "List projects (id, name, client, status). BigTime API: GET /project.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"show_inactive": {
"type": "boolean",
"description": "Include inactive records (default false)."
}
}
},
"annotations": {
"title": "List projects",
"readOnlyHint": true
}
}Get one project by sid, with budget, dates and billing setup. BigTime API: GET /project/detail/{sid}.
| Parameter | Type | Description |
|---|---|---|
| view | string | Detail level (default Basic). |
| project_sid * | integer | Project sid (from bigtime_list_projects). |
{
"name": "bigtime_get_project",
"title": "Get a project",
"description": "Get one project by sid, with budget, dates and billing setup. BigTime API: GET /project/detail/{sid}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_sid"
],
"properties": {
"view": {
"enum": [
"Basic",
"Detailed"
],
"type": "string",
"description": "Detail level (default Basic)."
},
"project_sid": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Project sid (from bigtime_list_projects).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a project",
"readOnlyHint": true
}
}List the staff assigned to a project. BigTime API: GET /project/team/{sid}.
| Parameter | Type | Description |
|---|---|---|
| project_sid * | integer |
{
"name": "bigtime_get_project_team",
"title": "Get a project team",
"description": "List the staff assigned to a project. BigTime API: GET /project/team/{sid}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_sid"
],
"properties": {
"project_sid": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a project team",
"readOnlyHint": true
}
}List clients (id, name, client id). BigTime API: GET /client.
| Parameter | Type | Description |
|---|---|---|
| show_inactive | boolean | Include inactive records (default false). |
{
"name": "bigtime_list_clients",
"title": "List clients",
"description": "List clients (id, name, client id). BigTime API: GET /client.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"show_inactive": {
"type": "boolean",
"description": "Include inactive records (default false)."
}
}
},
"annotations": {
"title": "List clients",
"readOnlyHint": true
}
}Get one client by sid. BigTime API: GET /client/detail/{sid}.
| Parameter | Type | Description |
|---|---|---|
| view | string | Detail level (default Basic). |
| client_sid * | integer | Client sid (from bigtime_list_clients). |
{
"name": "bigtime_get_client",
"title": "Get a client",
"description": "Get one client by sid. BigTime API: GET /client/detail/{sid}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_sid"
],
"properties": {
"view": {
"enum": [
"Basic",
"Detailed"
],
"type": "string",
"description": "Detail level (default Basic)."
},
"client_sid": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Client sid (from bigtime_list_clients).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a client",
"readOnlyHint": true
}
}List the tasks of one project. BigTime API: GET /task/listByProject/{ProjectSid}.
| Parameter | Type | Description |
|---|---|---|
| project_sid * | integer | |
| show_completed | boolean | Include completed tasks (default false). |
{
"name": "bigtime_list_project_tasks",
"title": "List tasks of a project",
"description": "List the tasks of one project. BigTime API: GET /task/listByProject/{ProjectSid}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_sid"
],
"properties": {
"project_sid": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"show_completed": {
"type": "boolean",
"description": "Include completed tasks (default false)."
}
}
},
"annotations": {
"title": "List tasks of a project",
"readOnlyHint": true
}
}List the tasks assigned to one staff member. BigTime API: GET /task/ListByStaffer/{StaffSid}.
| Parameter | Type | Description |
|---|---|---|
| staff_sid * | integer | |
| show_completed | boolean | Include completed tasks (default false). |
{
"name": "bigtime_list_staff_tasks",
"title": "List tasks of a staff member",
"description": "List the tasks assigned to one staff member. BigTime API: GET /task/ListByStaffer/{StaffSid}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"staff_sid"
],
"properties": {
"staff_sid": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"show_completed": {
"type": "boolean",
"description": "Include completed tasks (default false)."
}
}
},
"annotations": {
"title": "List tasks of a staff member",
"readOnlyHint": true
}
}Get one task by sid. BigTime API: GET /task/detail/{TaskSid}.
| Parameter | Type | Description |
|---|---|---|
| view | string | Detail level (default Basic). |
| task_sid * | integer |
{
"name": "bigtime_get_task",
"title": "Get a task",
"description": "Get one task by sid. BigTime API: GET /task/detail/{TaskSid}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"task_sid"
],
"properties": {
"view": {
"enum": [
"Basic",
"Detailed"
],
"type": "string",
"description": "Detail level (default Basic)."
},
"task_sid": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a task",
"readOnlyHint": true
}
}List the time entries of one staff member in a date range. BigTime API: GET /time/Sheet/{staffsid}.
| Parameter | Type | Description |
|---|---|---|
| view | string | Use Detailed for all fields. |
| end_date * | string | |
| staff_sid * | integer | |
| start_date * | string |
{
"name": "bigtime_get_timesheet",
"title": "Get a timesheet",
"description": "List the time entries of one staff member in a date range. BigTime API: GET /time/Sheet/{staffsid}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"staff_sid",
"start_date",
"end_date"
],
"properties": {
"view": {
"enum": [
"Detailed"
],
"type": "string",
"description": "Use Detailed for all fields."
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"staff_sid": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
}
},
"annotations": {
"title": "Get a timesheet",
"readOnlyHint": true
}
}List the time entries logged on one project in a date range. BigTime API: GET /time/ByProject/{Id}.
| Parameter | Type | Description |
|---|---|---|
| view | string | one of ["Detailed"] |
| end_date * | string | |
| start_date * | string | |
| is_approved | boolean | Only approved (true) or unapproved (false) entries. |
| project_sid * | integer |
{
"name": "bigtime_list_project_time",
"title": "List time entries of a project",
"description": "List the time entries logged on one project in a date range. BigTime API: GET /time/ByProject/{Id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_sid",
"start_date",
"end_date"
],
"properties": {
"view": {
"enum": [
"Detailed"
],
"type": "string"
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"is_approved": {
"type": "boolean",
"description": "Only approved (true) or unapproved (false) entries."
},
"project_sid": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List time entries of a project",
"readOnlyHint": true
}
}Get one time entry by sid. BigTime API: GET /time/{sid}.
| Parameter | Type | Description |
|---|---|---|
| time_sid * | integer |
{
"name": "bigtime_get_time_entry",
"title": "Get a time entry",
"description": "Get one time entry by sid. BigTime API: GET /time/{sid}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"time_sid"
],
"properties": {
"time_sid": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a time entry",
"readOnlyHint": true
}
}Get the hours per day for one staff member in a date range. BigTime API: GET /time/TotalByDay/{staffsid}.
| Parameter | Type | Description |
|---|---|---|
| end_date * | string | |
| staff_sid * | integer | |
| start_date * | string |
{
"name": "bigtime_get_daily_totals",
"title": "Get daily hour totals",
"description": "Get the hours per day for one staff member in a date range. BigTime API: GET /time/TotalByDay/{staffsid}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"staff_sid",
"start_date",
"end_date"
],
"properties": {
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"staff_sid": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
}
},
"annotations": {
"title": "Get daily hour totals",
"readOnlyHint": true
}
}Get one expense entry by sid. BigTime API: GET /expense/detail/{sid}.
| Parameter | Type | Description |
|---|---|---|
| expense_sid * | integer |
{
"name": "bigtime_get_expense",
"title": "Get an expense entry",
"description": "Get one expense entry by sid. BigTime API: GET /expense/detail/{sid}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"expense_sid"
],
"properties": {
"expense_sid": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get an expense entry",
"readOnlyHint": true
}
}List expense reports. BigTime API: GET /expense/reports.
| Parameter | Type | Description |
|---|---|---|
| show_all | boolean | Show all reports, not only open ones. |
{
"name": "bigtime_list_expense_reports",
"title": "List expense reports",
"description": "List expense reports. BigTime API: GET /expense/reports.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"show_all": {
"type": "boolean",
"description": "Show all reports, not only open ones."
}
}
},
"annotations": {
"title": "List expense reports",
"readOnlyHint": true
}
}List issued invoices in a date range. BigTime API: GET /invoice/history.
| Parameter | Type | Description |
|---|---|---|
| end_date * | string | |
| start_date * | string |
{
"name": "bigtime_list_invoices",
"title": "List invoice history",
"description": "List issued invoices in a date range. BigTime API: GET /invoice/history.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"start_date",
"end_date"
],
"properties": {
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
}
},
"annotations": {
"title": "List invoice history",
"readOnlyHint": true
}
}List draft invoices, optionally in a date range. BigTime API: GET /invoice/drafts.
| Parameter | Type | Description |
|---|---|---|
| end_date | string | |
| start_date | string |
{
"name": "bigtime_list_draft_invoices",
"title": "List draft invoices",
"description": "List draft invoices, optionally in a date range. BigTime API: GET /invoice/drafts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
}
},
"annotations": {
"title": "List draft invoices",
"readOnlyHint": true
}
}Get one invoice by sid. BigTime API: GET /invoice/detail/{sid}.
| Parameter | Type | Description |
|---|---|---|
| invoice_sid * | integer |
{
"name": "bigtime_get_invoice",
"title": "Get an invoice",
"description": "Get one invoice by sid. BigTime API: GET /invoice/detail/{sid}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"invoice_sid"
],
"properties": {
"invoice_sid": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get an invoice",
"readOnlyHint": true
}
}List the invoices of one client in a date range. BigTime API: GET /invoice/GetInvoicesByClientId.
| Parameter | Type | Description |
|---|---|---|
| end_date | string | |
| client_sid * | integer | |
| start_date | string |
{
"name": "bigtime_list_client_invoices",
"title": "List invoices of a client",
"description": "List the invoices of one client in a date range. BigTime API: GET /invoice/GetInvoicesByClientId.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_sid"
],
"properties": {
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"client_sid": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
}
},
"annotations": {
"title": "List invoices of a client",
"readOnlyHint": true
}
}List payments received in a date range. BigTime API: GET /payment/history.
| Parameter | Type | Description |
|---|---|---|
| end_date * | string | |
| start_date * | string |
{
"name": "bigtime_list_payments",
"title": "List payment history",
"description": "List payments received in a date range. BigTime API: GET /payment/history.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"start_date",
"end_date"
],
"properties": {
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
}
},
"annotations": {
"title": "List payment history",
"readOnlyHint": true
}
}Get the definition (fields and filters) of a saved report. BigTime API: GET /report/detail/{id}.
| Parameter | Type | Description |
|---|---|---|
| report_id * | integer |
{
"name": "bigtime_get_report_definition",
"title": "Get a report definition",
"description": "Get the definition (fields and filters) of a saved report. BigTime API: GET /report/detail/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"report_id"
],
"properties": {
"report_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get a report definition",
"readOnlyHint": true
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| filters | object | Report filter values. |
| report_id * | integer |
{
"name": "bigtime_run_report",
"title": "Run a saved report",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"report_id"
],
"properties": {
"filters": {
"type": "object",
"description": "Report filter values.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
}
},
"report_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Run a saved report",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| date * | string | Work date, yyyy-mm-dd. |
| hours * | number | Hours worked, for example 1.25. |
| notes | string | Notes for the entry. |
| task_sid | integer | Optional task sid on the project. |
| staff_sid * | integer | Staff sid the time belongs to. |
| project_sid * | integer | Project sid to log against. |
| mark_submitted | boolean | Submit the entry for approval (default false). |
{
"name": "bigtime_create_time_entry",
"title": "Create a time entry",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"staff_sid",
"project_sid",
"date",
"hours"
],
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Work date, yyyy-mm-dd."
},
"hours": {
"type": "number",
"maximum": 24,
"description": "Hours worked, for example 1.25.",
"exclusiveMinimum": 0
},
"notes": {
"type": "string",
"maxLength": 2000,
"description": "Notes for the entry."
},
"task_sid": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Optional task sid on the project.",
"exclusiveMinimum": 0
},
"staff_sid": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Staff sid the time belongs to.",
"exclusiveMinimum": 0
},
"project_sid": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Project sid to log against.",
"exclusiveMinimum": 0
},
"mark_submitted": {
"type": "boolean",
"description": "Submit the entry for approval (default false)."
}
}
},
"annotations": {
"title": "Create a time entry",
"destructiveHint": true
}
}Tools for BigTime, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "How many hours did each person on my team log last week?"; "Which projects are over budget this month?"; "List all draft invoices and the client for each.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes BigTime data. Free plan: 50 tool calls per month. Run bigtime_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run bigtime_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run bigtime_upgrade without a plan: it returns both plans, each with a payment link for the user to open. bigtime_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.