BigTime MCP by usefulapi

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

我该使用它吗

质量与安全性

A
描述质量
100%
模式完整度
87%
命名质量
80%
投毒风险
100%
权限匹配度
100%
协议合规性
100%

基于对工具定义和协议合规性的自动分析。

上下文开销

~3,261token 数(工具定义)
~901 B典型响应大小
对注意力有显著影响(占 128k 上下文窗口的 2.55%)

这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 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"
}

社区

评价此服务器

证据

最近观测

已验证未记录版本24 个工具