BigTime MCP by usefulapi
Read staff, projects, clients, time, expenses and invoices; create time entries in BigTime.
我该使用它吗
质量与安全性
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高,可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中:
{
"mcpServers": {
"bigtime": {
"url": "https://bigtime.usefulapi.io/mcp"
}
}
}远程端点
https://bigtime.usefulapi.io/mcpstreamable-http它能做什么
工具清单
工具(24)
🟢bigtime_list_staff(show_inactive)
List staff members (id = staff sid, name, email). Good first call. BigTime API: GET /staff.
输入模式
{
"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}.
输入模式
{
"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.
输入模式
{
"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}.
输入模式
{
"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}.
输入模式
{
"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.
输入模式
{
"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}.
输入模式
{
"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}.
输入模式
{
"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}.
输入模式
{
"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}.
输入模式
{
"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}.
输入模式
{
"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}.
输入模式
{
"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}.
输入模式
{
"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}.
输入模式
{
"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}.
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"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}.
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"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}.
输入模式
{
"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}.
输入模式
{
"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.
输入模式
{
"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"
}社区
证据