BigTime MCP by usefulapi
Read staff, projects, clients, time, expenses and invoices; create time entries in BigTime.
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `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"
}コミュニティ
エビデンス