Timicx MCP by usefulapi
Read, book, change and delete time entries and run live timers in Timicx.
Should I use this
Quality & Safety
Findings (1)
- LOWin timicx_finish_timer
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"timicx": {
"url": "https://timicx.usefulapi.io/mcp"
}
}
}Remote endpoints
https://timicx.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (16)
🟢timicx_list_time_entries(date, date_from, date_till, employee_id, project_id, ...)
List time bookings (project_time) with date, employee, project, task, duration in seconds, status and billable flag. Filter by date range, employee, project, task or status. Timicx API: GET /ws/2.0/project_time.json.
Input Schema
{
"type": "object",
"properties": {
"date": {
"description": "Only bookings on this date.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"date_from": {
"description": "Only bookings from this date (inclusive).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"date_till": {
"description": "Only bookings up to this date (inclusive).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"employee_id": {
"description": "Only bookings of this employee.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"project_id": {
"description": "Only bookings of this project (not its sub-projects).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"parent_project_id": {
"description": "Only bookings of this project and all its sub-projects.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"task_id": {
"description": "Only bookings with this task.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"billable": {
"description": "Only billable (true) or non-billable (false) bookings.",
"type": "boolean"
},
"status": {
"description": "0 finished, 1 running, 2 paused.",
"type": "integer",
"minimum": 0,
"maximum": 2
},
"limit": {
"description": "Maximum number of records (Timicx default 100).",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"offset": {
"description": "Records to skip, counted from 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"order_by": {
"description": "Field to sort by, for example id or date.",
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,40}$"
},
"order_direction": {
"description": "Sort direction (default ASC).",
"type": "string",
"enum": [
"ASC",
"DESC"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timicx_get_time_entry(time_entry_id)
Get one time booking by id, with employee, project, task, duration, begin and end. Timicx API: GET /ws/2.0/project_time/{id}.json.
Input Schema
{
"type": "object",
"properties": {
"time_entry_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric Timicx id."
}
},
"required": [
"time_entry_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timicx_list_running_timers
List the live timers that are running or paused right now. Timicx API: GET /ws/2.0/project_time/running.json.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timicx_list_employees(enabled_only, limit, offset, order_by, order_direction)
List the employees of the Timicx system (user name, full name, employee number, enabled flag). Timicx API: GET /ws/2.0/employees.json. Some employee logins may not see the full list.
Input Schema
{
"type": "object",
"properties": {
"enabled_only": {
"description": "Only active employees (default false).",
"type": "boolean"
},
"limit": {
"description": "Maximum number of records (Timicx default 100).",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"offset": {
"description": "Records to skip, counted from 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"order_by": {
"description": "Field to sort by, for example id or date.",
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,40}$"
},
"order_direction": {
"description": "Sort direction (default ASC).",
"type": "string",
"enum": [
"ASC",
"DESC"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timicx_get_employee(employee_id)
Get one employee by id, with groups, email, employee number and standard hourly rate. Timicx API: GET /ws/2.0/employees/{id}.json.
Input Schema
{
"type": "object",
"properties": {
"employee_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric Timicx id."
}
},
"required": [
"employee_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timicx_list_projects(name, description, active, parent_id, top_level_only, ...)
List projects with name, description, active flag and parent. Use top_level_only for the projects at the top of the tree. Timicx API: GET /ws/2.0/projects.json.
Input Schema
{
"type": "object",
"properties": {
"name": {
"description": "Project name; * is a wildcard.",
"type": "string",
"maxLength": 200
},
"description": {
"description": "Project description; * is a wildcard.",
"type": "string",
"maxLength": 200
},
"active": {
"description": "Only active (true) or closed (false) projects.",
"type": "boolean"
},
"parent_id": {
"description": "Only the direct sub-projects of this project.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"top_level_only": {
"description": "Only the projects at the top level (wins over parent_id).",
"type": "boolean"
},
"limit": {
"description": "Maximum number of records (Timicx default 100).",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"offset": {
"description": "Records to skip, counted from 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"order_by": {
"description": "Field to sort by, for example id or date.",
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,40}$"
},
"order_direction": {
"description": "Sort direction (default ASC).",
"type": "string",
"enum": [
"ASC",
"DESC"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timicx_get_project(project_id)
Get one project by id, with its parent, children, estimated time and estimated completion date. Timicx API: GET /ws/2.0/projects/{id}.json.
Input Schema
{
"type": "object",
"properties": {
"project_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric Timicx id."
}
},
"required": [
"project_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timicx_list_tasks(limit, offset, order_by, order_direction)
List the tasks (activities) that time can be booked on, with billable flag and rate. Timicx API: GET /ws/2.0/tasks.json.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "Maximum number of records (Timicx default 100).",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"offset": {
"description": "Records to skip, counted from 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"order_by": {
"description": "Field to sort by, for example id or date.",
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_]{0,40}$"
},
"order_direction": {
"description": "Sort direction (default ASC).",
"type": "string",
"enum": [
"ASC",
"DESC"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timicx_get_task(task_id)
Get one task by id, with its billable flag, group restriction and external rate. Timicx API: GET /ws/2.0/tasks/{id}.json.
Input Schema
{
"type": "object",
"properties": {
"task_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric Timicx id."
}
},
"required": [
"task_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴timicx_create_time_entry(date, task_id, duration_seconds, project_id, employee_id, ...)
Book time: a finished time entry with date, task and duration in seconds (optional project, employee, begin, end, billable, comment). Writes a new booking. Timicx API: POST /ws/2.0/project_time.json.
Input Schema
{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date as yyyy-mm-dd."
},
"task_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The task the time is booked on."
},
"duration_seconds": {
"type": "integer",
"minimum": 1,
"maximum": 2678400,
"description": "Duration in seconds."
},
"project_id": {
"description": "The project. Leave out for a booking without project.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"employee_id": {
"description": "The employee. Default: the logged-in employee.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"begin": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
"description": "Date and time as yyyy-mm-dd hh:mm:ss."
},
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
"description": "Date and time as yyyy-mm-dd hh:mm:ss."
},
"billable": {
"type": "boolean"
},
"comment": {
"description": "Comment of the booking.",
"type": "string",
"maxLength": 2000
}
},
"required": [
"date",
"task_id",
"duration_seconds"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡timicx_update_time_entry(time_entry_id, date, task_id, project_id, employee_id, ...)
Change fields of a time entry. Only the given fields change: the tool reads the booking first and sends all writable fields back. At least one field is needed. Timicx API: GET then PUT /ws/2.0/project_time/{id}.json.
Input Schema
{
"type": "object",
"properties": {
"time_entry_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric Timicx id."
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date as yyyy-mm-dd."
},
"task_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric Timicx id."
},
"project_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric Timicx id."
},
"employee_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric Timicx id."
},
"duration_seconds": {
"type": "integer",
"minimum": 1,
"maximum": 2678400
},
"begin": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
"description": "Date and time as yyyy-mm-dd hh:mm:ss."
},
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
"description": "Date and time as yyyy-mm-dd hh:mm:ss."
},
"billable": {
"type": "boolean"
},
"comment": {
"description": "Comment of the booking.",
"type": "string",
"maxLength": 2000
}
},
"required": [
"time_entry_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴timicx_start_timer(project_id, task_id, comment)
Start a live timer (like a stopwatch) for the logged-in employee. Optional project, task and comment. Timicx API: POST /ws/2.0/project_time/start.json.
Input Schema
{
"type": "object",
"properties": {
"project_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric Timicx id."
},
"task_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric Timicx id."
},
"comment": {
"description": "Comment of the booking.",
"type": "string",
"maxLength": 2000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡timicx_pause_timer(timer_id, comment)
Pause a running live timer. Optional comment. Timicx API: PUT /ws/2.0/project_time/pause/{id}.json.
Input Schema
{
"type": "object",
"properties": {
"timer_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric Timicx id."
},
"comment": {
"description": "Comment of the booking.",
"type": "string",
"maxLength": 2000
}
},
"required": [
"timer_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡timicx_resume_timer(timer_id, comment)
Resume a paused live timer. Optional comment. Timicx API: PUT /ws/2.0/project_time/resume/{id}.json.
Input Schema
{
"type": "object",
"properties": {
"timer_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric Timicx id."
},
"comment": {
"description": "Comment of the booking.",
"type": "string",
"maxLength": 2000
}
},
"required": [
"timer_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡timicx_finish_timer(timer_id, comment)
Finish a live timer and keep its time as a booking. Optional comment. Timicx API: PUT /ws/2.0/project_time/finish/{id}.json.
Input Schema
{
"type": "object",
"properties": {
"timer_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric Timicx id."
},
"comment": {
"description": "Comment of the booking.",
"type": "string",
"maxLength": 2000
}
},
"required": [
"timer_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴timicx_delete_time_entry(time_entry_id)
Delete a time booking. A running or paused live timer is cancelled the same way. This cannot be undone. Timicx API: DELETE /ws/2.0/project_time/{id}.json.
Input Schema
{
"type": "object",
"properties": {
"time_entry_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Numeric Timicx id."
}
},
"required": [
"time_entry_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence