BigTime MCP by usefulapi
Read staff, projects, clients, time, expenses and invoices; create time entries in BigTime.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"bigtime": {
"url": "https://bigtime.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://bigtime.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (24)
🟢bigtime_list_staff(show_inactive)
List staff members (id = staff sid, name, email). Good first call. BigTime API: GET /staff.
Eingabe-Schema
{
"type": "object",
"properties": {
"show_inactive": {
"description": "Include inactive records (default false).",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢bigtime_get_staff(staff_sid, view)
Get one staff member by staff sid. BigTime API: GET /staff/detail/{sid}.
Eingabe-Schema
{
"type": "object",
"properties": {
"staff_sid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Staff sid (from bigtime_list_staff)."
},
"view": {
"description": "Detail level (default Basic).",
"type": "string",
"enum": [
"Basic",
"Detailed"
]
}
},
"required": [
"staff_sid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢bigtime_list_projects(show_inactive)
List projects (id, name, client, status). BigTime API: GET /project.
Eingabe-Schema
{
"type": "object",
"properties": {
"show_inactive": {
"description": "Include inactive records (default false).",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢bigtime_get_project(project_sid, view)
Get one project by sid, with budget, dates and billing setup. BigTime API: GET /project/detail/{sid}.
Eingabe-Schema
{
"type": "object",
"properties": {
"project_sid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Project sid (from bigtime_list_projects)."
},
"view": {
"description": "Detail level (default Basic).",
"type": "string",
"enum": [
"Basic",
"Detailed"
]
}
},
"required": [
"project_sid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢bigtime_get_project_team(project_sid)
List the staff assigned to a project. BigTime API: GET /project/team/{sid}.
Eingabe-Schema
{
"type": "object",
"properties": {
"project_sid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"project_sid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢bigtime_list_clients(show_inactive)
List clients (id, name, client id). BigTime API: GET /client.
Eingabe-Schema
{
"type": "object",
"properties": {
"show_inactive": {
"description": "Include inactive records (default false).",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢bigtime_get_client(client_sid, view)
Get one client by sid. BigTime API: GET /client/detail/{sid}.
Eingabe-Schema
{
"type": "object",
"properties": {
"client_sid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Client sid (from bigtime_list_clients)."
},
"view": {
"description": "Detail level (default Basic).",
"type": "string",
"enum": [
"Basic",
"Detailed"
]
}
},
"required": [
"client_sid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢bigtime_list_project_tasks(project_sid, show_completed)
List the tasks of one project. BigTime API: GET /task/listByProject/{ProjectSid}.
Eingabe-Schema
{
"type": "object",
"properties": {
"project_sid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"show_completed": {
"description": "Include completed tasks (default false).",
"type": "boolean"
}
},
"required": [
"project_sid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢bigtime_list_staff_tasks(staff_sid, show_completed)
List the tasks assigned to one staff member. BigTime API: GET /task/ListByStaffer/{StaffSid}.
Eingabe-Schema
{
"type": "object",
"properties": {
"staff_sid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"show_completed": {
"description": "Include completed tasks (default false).",
"type": "boolean"
}
},
"required": [
"staff_sid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢bigtime_get_task(task_sid, view)
Get one task by sid. BigTime API: GET /task/detail/{TaskSid}.
Eingabe-Schema
{
"type": "object",
"properties": {
"task_sid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"view": {
"description": "Detail level (default Basic).",
"type": "string",
"enum": [
"Basic",
"Detailed"
]
}
},
"required": [
"task_sid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢bigtime_get_timesheet(staff_sid, start_date, end_date, view)
List the time entries of one staff member in a date range. BigTime API: GET /time/Sheet/{staffsid}.
Eingabe-Schema
{
"type": "object",
"properties": {
"staff_sid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"view": {
"description": "Use Detailed for all fields.",
"type": "string",
"enum": [
"Detailed"
]
}
},
"required": [
"staff_sid",
"start_date",
"end_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢bigtime_list_project_time(project_sid, start_date, end_date, is_approved, view)
List the time entries logged on one project in a date range. BigTime API: GET /time/ByProject/{Id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"project_sid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"is_approved": {
"description": "Only approved (true) or unapproved (false) entries.",
"type": "boolean"
},
"view": {
"type": "string",
"enum": [
"Detailed"
]
}
},
"required": [
"project_sid",
"start_date",
"end_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢bigtime_get_time_entry(time_sid)
Get one time entry by sid. BigTime API: GET /time/{sid}.
Eingabe-Schema
{
"type": "object",
"properties": {
"time_sid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"time_sid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢bigtime_get_daily_totals(staff_sid, start_date, end_date)
Get the hours per day for one staff member in a date range. BigTime API: GET /time/TotalByDay/{staffsid}.
Eingabe-Schema
{
"type": "object",
"properties": {
"staff_sid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"staff_sid",
"start_date",
"end_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢bigtime_get_expense(expense_sid)
Get one expense entry by sid. BigTime API: GET /expense/detail/{sid}.
Eingabe-Schema
{
"type": "object",
"properties": {
"expense_sid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"expense_sid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢bigtime_list_expense_reports(show_all)
List expense reports. BigTime API: GET /expense/reports.
Eingabe-Schema
{
"type": "object",
"properties": {
"show_all": {
"description": "Show all reports, not only open ones.",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢bigtime_list_invoices(start_date, end_date)
List issued invoices in a date range. BigTime API: GET /invoice/history.
Eingabe-Schema
{
"type": "object",
"properties": {
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"start_date",
"end_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢bigtime_list_draft_invoices(start_date, end_date)
List draft invoices, optionally in a date range. BigTime API: GET /invoice/drafts.
Eingabe-Schema
{
"type": "object",
"properties": {
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢bigtime_get_invoice(invoice_sid)
Get one invoice by sid. BigTime API: GET /invoice/detail/{sid}.
Eingabe-Schema
{
"type": "object",
"properties": {
"invoice_sid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"invoice_sid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢bigtime_list_client_invoices(client_sid, start_date, end_date)
List the invoices of one client in a date range. BigTime API: GET /invoice/GetInvoicesByClientId.
Eingabe-Schema
{
"type": "object",
"properties": {
"client_sid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"client_sid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢bigtime_list_payments(start_date, end_date)
List payments received in a date range. BigTime API: GET /payment/history.
Eingabe-Schema
{
"type": "object",
"properties": {
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"start_date",
"end_date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢bigtime_get_report_definition(report_id)
Get the definition (fields and filters) of a saved report. BigTime API: GET /report/detail/{id}.
Eingabe-Schema
{
"type": "object",
"properties": {
"report_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"report_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢bigtime_run_report(report_id, filters)
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}.
Eingabe-Schema
{
"type": "object",
"properties": {
"report_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"filters": {
"description": "Report filter values.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
}
}
},
"required": [
"report_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴bigtime_create_time_entry(staff_sid, project_sid, date, hours, notes, ...)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"staff_sid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Staff sid the time belongs to."
},
"project_sid": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Project sid to log against."
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Work date, yyyy-mm-dd."
},
"hours": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 24,
"description": "Hours worked, for example 1.25."
},
"notes": {
"description": "Notes for the entry.",
"type": "string",
"maxLength": 2000
},
"task_sid": {
"description": "Optional task sid on the project.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"mark_submitted": {
"description": "Submit the entry for approval (default false).",
"type": "boolean"
}
},
"required": [
"staff_sid",
"project_sid",
"date",
"hours"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis