BigTime MCP by usefulapi
Read staff, projects, clients, time, expenses and invoices; create time entries in BigTime.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"bigtime": {
"url": "https://bigtime.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://bigtime.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (24)
🟢bigtime_list_staff(show_inactive)
List staff members (id = staff sid, name, email). Good first call. BigTime API: GET /staff.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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"
}Comunidad
Evidencia