Timicx MCP by usefulapi

Read, book, change and delete time entries and run live timers in Timicx.

Should I use this

Quality & Safety

A
Description quality
98%
Schema completeness
92%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (1)

  • LOWTool 'timicx_finish_timer' description lacks action verbin timicx_finish_timer

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~3,497Tokens (tool definitions)
~1.6 KBTypical response size
Significant attention impact (2.73% of 128k context)

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-http

What it can do

Tool inventory

Tools (16)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded16 tools