Timicx MCP by usefulapi

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

使うべきか

品質と安全性

A
説明の品質
98%
スキーマの完全性
92%
命名の品質
80%
ポイズニングのリスク
100%
権限の一致
100%
プロトコルへの準拠
100%

検出事項(1)

  • LOWTool 'timicx_finish_timer' description lacks action verbtimicx_finish_timer 内

ツール定義とプロトコルへの準拠に関する自動分析に基づいています。

コンテキストコスト

~3,497トークン数(ツール定義)
~1.6 KB一般的なレスポンスサイズ
注意への影響は大きい(128k コンテキストの 2.73%)

これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。

インストール

ワンクリックインストール

これを `claude_desktop_config.json` ファイルに追加してください:

{
  "mcpServers": {
    "timicx": {
      "url": "https://timicx.usefulapi.io/mcp"
    }
  }
}

リモートエンドポイント

https://timicx.usefulapi.io/mcpstreamable-http

できること

ツール一覧

ツール(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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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"
}

コミュニティ

このサーバーを評価する

エビデンス

最近の観測

検証済みバージョンは記録されていませんツール 16 件