ClickTime MCP by usefulapi
Read jobs, timesheets and reports; log time, update entries and submit timesheets in ClickTime.
使うべきか
品質と安全性
A
検出事項（4）
- LOWTool 'clicktime_list_job_task_controls' name length outside 3-30 rangeclicktime_list_job_task_controls 内
- LOWTool 'clicktime_get_timesheet_by_date' name length outside 3-30 rangeclicktime_get_timesheet_by_date 内
- LOWTool 'clicktime_list_timesheet_actions' name length outside 3-30 rangeclicktime_list_timesheet_actions 内
- LOWTool 'clicktime_list_time_off_requests' name length outside 3-30 rangeclicktime_list_time_off_requests 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
~7,931トークン数（ツール定義）
~2.3 KB一般的なレスポンスサイズ
注意への影響は大きい（128k コンテキストの 6.20%）
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"clicktime": {
"url": "https://clicktime.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://clicktime.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール（26）
🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢clicktime_get_me
The ClickTime user this API token belongs to: id, name, email, security level (Standard, Manager, Admin), division, default task, approvers and timesheet preferences. The API token itself is never returned. GET /Me.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clicktime_get_company
Company configuration: name, currency, week start, timesheet model, how the company names jobs/clients/tasks, restriction methods, and which optional modules are on (Expenses, TimeOffAccruals, SubJob phases). Call this first before using expense, time-off-request or phase tools. GET /Company.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clicktime_list_jobs(name, job_number, client_id, is_active, my_jobs, ...)
List the jobs (projects) the token's user can log time to, by name, with job number, client, dates and active state. Use the ids to log time or filter entries. GET /Me/Jobs.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"description": "Only jobs with exactly this name.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"job_number": {
"description": "Only the job with this job number.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"client_id": {
"description": "Only jobs of this client id (see clicktime_list_clients).",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"is_active": {
"description": "true = active jobs only, false = inactive only (default: both).",
"type": "boolean"
},
"my_jobs": {
"description": "true = only jobs assigned to the user (company job-list controls).",
"type": "boolean"
},
"verbose": {
"description": "Also return the related Job/Client/Task/User objects and billable flags (slower, larger).",
"type": "boolean"
},
"limit": {
"description": "Results per page, 1-1000 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1000
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clicktime_get_job(job_id, verbose)
One job (project) by id: name, number, client, start/end dates, active state. GET /Me/Jobs/{jobID}.
入力スキーマ
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$",
"description": "ClickTime job id."
},
"verbose": {
"description": "Also return the related Job/Client/Task/User objects and billable flags (slower, larger).",
"type": "boolean"
}
},
"required": [
"job_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clicktime_list_clients(name, short_name, client_number, is_active, limit, ...)
List the clients the token's user can see, with client number, short name and active state. GET /Me/Clients.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"description": "Only clients with exactly this name.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"short_name": {
"description": "Only the client with this short name.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"client_number": {
"description": "Only the client with this client number.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"is_active": {
"description": "true = active only, false = inactive only (default: both).",
"type": "boolean"
},
"limit": {
"description": "Results per page, 1-1000 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1000
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clicktime_list_tasks(name, task_code, is_active, my_tasks, limit, ...)
List the tasks (work categories) the token's user can log time against, with task code and active state. When the company restricts tasks per job, use clicktime_list_job_task_controls instead. GET /Me/Tasks.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"description": "Only tasks with exactly this name.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"task_code": {
"description": "Only the task with this task code.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"is_active": {
"description": "true = active only, false = inactive only (default: both).",
"type": "boolean"
},
"my_tasks": {
"description": "true = only tasks assigned to the user.",
"type": "boolean"
},
"limit": {
"description": "Results per page, 1-1000 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1000
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clicktime_list_job_task_controls(job_id, task_id, limit, offset)
The (job, task) combinations the user may log time on. Only valid when the company's TaskRestrictionMethod is 'byjob' (see clicktime_get_company); otherwise ClickTime answers 403. Active rows only unless filtered. GET /Me/Jobs/TaskControls.
入力スキーマ
{
"type": "object",
"properties": {
"job_id": {
"description": "Only pairs for this job id.",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"task_id": {
"description": "Only pairs for this task id.",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"limit": {
"description": "Results per page, 1-1000 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1000
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clicktime_list_job_phases(job_id, limit, offset)
The phases (sub-jobs, level 1) defined on a job. Needs the company's SubJob/phases module (see clicktime_get_company). Use the phase id when logging time on a phased job. GET /Me/Jobs/{jobID}/JobPhase.
入力スキーマ
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$",
"description": "ClickTime job id."
},
"limit": {
"description": "Results per page, 1-1000 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1000
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"required": [
"job_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clicktime_list_time_entries(start_date, end_date, entry_date, job_id, task_id, ...)
List the token user's time entries, newest first: date, hours, job, task, comment, start/end time. Filter by one day (entry_date), a date range (start_date + end_date), job or task. Only days with logged time appear. Add verbose to get job/client names and the billable flag. GET /Me/TimeEntries.
入力スキーマ
{
"type": "object",
"properties": {
"start_date": {
"description": "First day of a date range (yyyy-mm-dd); use with end_date.",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"end_date": {
"description": "Last day of a date range, included (yyyy-mm-dd).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"entry_date": {
"description": "Specific days (yyyy-mm-dd), up to 31.",
"minItems": 1,
"maxItems": 31,
"type": "array",
"items": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "A date, yyyy-mm-dd."
}
},
"job_id": {
"description": "Only entries on this job id.",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"task_id": {
"description": "Only entries on this task id.",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"verbose": {
"description": "Also return the related Job/Client/Task/User objects and billable flags (slower, larger).",
"type": "boolean"
},
"limit": {
"description": "Results per page, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clicktime_get_time_entry(time_entry_id, verbose)
One of the user's time entries by id, with hours, comment, date, job, task, phase and custom fields. GET /Me/TimeEntries/{timeEntryID}.
入力スキーマ
{
"type": "object",
"properties": {
"time_entry_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$",
"description": "ClickTime time entry id."
},
"verbose": {
"description": "Also return the related Job/Client/Task/User objects and billable flags (slower, larger).",
"type": "boolean"
}
},
"required": [
"time_entry_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clicktime_list_timesheets(status, from_date, to_date, limit, offset)
List the user's timesheets (pay periods), newest first, with period dates, status (Open, Waiting, Approved, Rejected, Locked...), total hours and who submitted or approved. GET /Me/Timesheets.
入力スキーマ
{
"type": "object",
"properties": {
"status": {
"description": "Only timesheets in these states (Waiting = submitted and awaiting approval; submitted is the vendor's own alias).",
"minItems": 1,
"maxItems": 8,
"type": "array",
"items": {
"type": "string",
"enum": [
"Open",
"Waiting",
"Approved",
"Rejected",
"Locked",
"JobHold",
"TORAHold",
"submitted"
]
}
},
"from_date": {
"description": "Only timesheets ending on or after this date (yyyy-mm-dd).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"to_date": {
"description": "Only timesheets starting on or before this date (yyyy-mm-dd).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"limit": {
"description": "Results per page, 1-1000 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1000
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clicktime_get_timesheet_by_date(date)
The user's timesheet whose period contains a given day: period dates, status, day totals and the general actions (Submit, UndoSubmit...). GET /Me/Timesheets/{date}.
入力スキーマ
{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Any day inside the timesheet period."
}
},
"required": [
"date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clicktime_list_timesheet_actions(date)
The status actions the user can take right now on the timesheet covering a date (Submit, UndoSubmit...). Check this before clicktime_submit_timesheet. GET /Me/Timesheets/{date}/Actions.
入力スキーマ
{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Any day inside the timesheet period."
}
},
"required": [
"date"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clicktime_list_time_off_types(is_active, requires_approval, limit, offset)
The time off types the user can take (vacation, sick...) with CurrentBalance, accrual and whether approval is required. Use for balance questions. GET /Me/TimeOffTypes.
入力スキーマ
{
"type": "object",
"properties": {
"is_active": {
"description": "true = active types only (the only ones that can be booked).",
"type": "boolean"
},
"requires_approval": {
"description": "Filter by approval-required types.",
"type": "boolean"
},
"limit": {
"description": "Results per page, 1-1000 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1000
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clicktime_list_time_off(from_date, to_date, time_off_type_id, limit, offset)
Time off the user has taken or booked, newest first: date, hours, type, notes. Not requests or balances. GET /Me/TimeOff.
入力スキーマ
{
"type": "object",
"properties": {
"from_date": {
"description": "Only entries on or after this date (yyyy-mm-dd).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"to_date": {
"description": "Only entries on or before this date (yyyy-mm-dd).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"time_off_type_id": {
"description": "Only this time off type id.",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"limit": {
"description": "Results per page, 1-500 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 500
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clicktime_list_time_off_requests(status, from_date, to_date, limit, offset)
The user's time off requests with status and dates. Needs the company's TimeOffAccruals module (see clicktime_get_company). GET /Me/TimeOffRequests.
入力スキーマ
{
"type": "object",
"properties": {
"status": {
"description": "Only requests in these statuses (Submitted = awaiting approval).",
"minItems": 1,
"maxItems": 4,
"type": "array",
"items": {
"type": "string",
"enum": [
"Submitted",
"Approved",
"Rejected",
"Cancelled"
]
}
},
"from_date": {
"description": "Only requests on or after this date (yyyy-mm-dd).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"to_date": {
"description": "Only requests on or before this date (yyyy-mm-dd).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"limit": {
"description": "Results per page, 1-1000 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1000
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clicktime_list_expense_sheets(from_date, to_date, status, paid, limit, ...)
The user's expense sheets with status, total and reimbursable amount, paid flag. Needs the company's Expenses module (see clicktime_get_company). GET /Me/ExpenseSheets.
入力スキーマ
{
"type": "object",
"properties": {
"from_date": {
"description": "Only sheets dated on or after this day (yyyy-mm-dd).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"to_date": {
"description": "Only sheets dated on or before this day (yyyy-mm-dd).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"status": {
"description": "Only sheets in these statuses (waiting = submitted for approval).",
"minItems": 1,
"maxItems": 5,
"type": "array",
"items": {
"type": "string",
"enum": [
"open",
"waiting",
"approved",
"rejected",
"paid"
]
}
},
"paid": {
"description": "true = paid sheets only, false = unpaid only.",
"type": "boolean"
},
"limit": {
"description": "Results per page, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clicktime_list_expense_items(from_date, to_date, expense_sheet_id, job_id, limit, ...)
The user's expense items: date, type, amount, description, job, billable flag, sheet. Receipt images are not fetched. Needs the Expenses module. GET /Me/ExpenseItems.
入力スキーマ
{
"type": "object",
"properties": {
"from_date": {
"description": "Only items dated on or after this day (yyyy-mm-dd).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"to_date": {
"description": "Only items dated on or before this day (yyyy-mm-dd).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"expense_sheet_id": {
"description": "Only items on this expense sheet id.",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"job_id": {
"description": "Only items charged to this job id.",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"limit": {
"description": "Results per page, 1-500 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 500
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clicktime_list_users(name, email, is_active, division_id, limit, ...)
List people in the company with name, email, security level, division, approvers and active state. Needs a Manager or Admin token (others get 403). Cost and billing rates are included for Admins. GET /Users.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"description": "Only the user with exactly this name.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"email": {
"description": "Only the user with this email.",
"type": "string",
"minLength": 3,
"maxLength": 254
},
"is_active": {
"description": "true = active only, false = inactive only (default: both).",
"type": "boolean"
},
"division_id": {
"description": "Only users in this division id.",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"limit": {
"description": "Results per page, 1-1000 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1000
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clicktime_time_report(start_date, end_date, user_id, job_id, client_id, ...)
Company-wide time entries (what the Time report shows): date, user, job, client, task, hours, billable flag, rates. Filter by date range, user, job, client, task, division or billable. Needs an Admin, or a Manager allowed to run company reports. Up to 2500 rows per page. GET /Reports/Time.
入力スキーマ
{
"type": "object",
"properties": {
"start_date": {
"description": "First day (yyyy-mm-dd).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"end_date": {
"description": "Last day, included (yyyy-mm-dd).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"user_id": {
"description": "Only this user id (see clicktime_list_users).",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"job_id": {
"description": "Only this job id.",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"client_id": {
"description": "Only this client id.",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"task_id": {
"description": "Only this task id.",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"division_id": {
"description": "Only this division id.",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"is_billable": {
"description": "true = billable time only, false = non-billable only.",
"type": "boolean"
},
"limit": {
"description": "Results per page, 1-2500 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 2500
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢clicktime_time_summary(group_by, job_id, user_id, task_id, start_date, ...)
Hours, billable hours, billings and cost totals grouped by Job, Task, User, Month, Date or WorkType (several groupings combine, for example Job + User). Needs a Manager or Admin token. ClickTime requires at least one of job_id, user_id or task_id as a filter. GET /Reports/TimeSummary.
入力スキーマ
{
"type": "object",
"properties": {
"group_by": {
"minItems": 1,
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"enum": [
"Job",
"Task",
"User",
"Month",
"Date",
"WorkType"
]
},
"description": "What to group the totals by: one of Job, Task, User, Month, Date, WorkType, or one of the pairs Task+User, Job+Task, Job+User, Job+Month."
},
"job_id": {
"description": "Only this job id.",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"user_id": {
"description": "Only this user id.",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"task_id": {
"description": "Only this task id.",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"start_date": {
"description": "First day (yyyy-mm-dd).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"end_date": {
"description": "Last day, included (yyyy-mm-dd).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"job_is_active": {
"description": "true = active jobs only.",
"type": "boolean"
},
"limit": {
"description": "Results per page, 1-2500 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 2500
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"required": [
"group_by"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡clicktime_create_time_entry(job_id, hours, task_id, date, comment, ...)
WRITE: log a time entry on the token user's own timesheet. Needs job_id and hours; task_id falls back to the user's default task; date defaults to today. Creates a NEW entry each call (not idempotent) and fails on a locked or submitted timesheet. Confirm date, hours, job, task and comment with the user first. POST /Me/TimeEntries.
入力スキーマ
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$",
"description": "Job id (see clicktime_list_jobs)."
},
"hours": {
"type": "number",
"minimum": 0,
"maximum": 24,
"description": "Hours worked, 0-24 (two decimals are kept)."
},
"task_id": {
"description": "Task id; omitted = the user's default task. Under per-job task restrictions it must be valid for the job.",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"date": {
"description": "Day worked, yyyy-mm-dd (default: today).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"comment": {
"description": "Comment, up to 2000 characters (some companies require one).",
"type": "string",
"maxLength": 2000
},
"start_time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Time of day, HH:MM (24-hour)."
},
"end_time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Time of day, HH:MM (24-hour)."
},
"break_time": {
"description": "Break hours.",
"type": "number",
"minimum": 0,
"maximum": 24
},
"phase_id": {
"description": "Phase id, on companies with phases.",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"sub_phase_id": {
"description": "Sub-phase id, on companies with two phase levels.",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"dcaa_explanation": {
"description": "Explanation required by DCAA-enabled companies when changing a past date.",
"type": "string",
"maxLength": 2000
}
},
"required": [
"job_id",
"hours"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴clicktime_update_time_entry(time_entry_id, hours, comment, job_id, task_id, ...)
WRITE: change one of the user's own time entries (hours, comment, job, task, start/end time, break). Only the fields you pass change; the date cannot be changed. Overwrites the previous values; a locked timesheet rejects it. Show the current and new values to the user first. PATCH /Me/TimeEntries/{timeEntryID}.
入力スキーマ
{
"type": "object",
"properties": {
"time_entry_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$",
"description": "Time entry id (see clicktime_list_time_entries)."
},
"hours": {
"type": "number",
"minimum": 0,
"maximum": 24,
"description": "Hours worked, 0-24 (two decimals are kept)."
},
"comment": {
"description": "New comment (up to 2000 characters).",
"type": "string",
"maxLength": 2000
},
"job_id": {
"description": "Move the entry to this job id.",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"task_id": {
"description": "Move the entry to this task id.",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"start_time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Time of day, HH:MM (24-hour)."
},
"end_time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Time of day, HH:MM (24-hour)."
},
"break_time": {
"description": "Break hours.",
"type": "number",
"minimum": 0,
"maximum": 24
},
"phase_id": {
"description": "Phase id.",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"sub_phase_id": {
"description": "Sub-phase id.",
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$"
},
"dcaa_explanation": {
"description": "Explanation required by DCAA-enabled companies when changing a past date.",
"type": "string",
"maxLength": 2000
}
},
"required": [
"time_entry_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴clicktime_submit_timesheet(date, action, comment, has_attestation)
WRITE: submit the user's timesheet covering a date for approval (action Submit), or recall it (UndoSubmit). Submitting locks the entries and notifies the approver; confirm with the user first. Check the available actions with clicktime_list_timesheet_actions first. POST /Me/Timesheets/{date}/Actions.
入力スキーマ
{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Any day inside the timesheet period."
},
"action": {
"type": "string",
"enum": [
"Submit",
"UndoSubmit"
],
"description": "Submit = send for approval; UndoSubmit = recall a submitted timesheet."
},
"comment": {
"description": "Optional comment for the approver (up to 2000 characters).",
"type": "string",
"maxLength": 2000
},
"has_attestation": {
"description": "true when the company requires attesting the timesheet is accurate and the user agrees.",
"type": "boolean"
}
},
"required": [
"date",
"action"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡clicktime_create_client(name, short_name, client_number, notes, is_active)
WRITE: create a client. Needs an Admin, or a Manager allowed to add clients. Creates a NEW client each call (not idempotent); check clicktime_list_clients first to avoid duplicates. POST /Clients.
入力スキーマ
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 50,
"description": "Client name (up to 50 characters)."
},
"short_name": {
"type": "string",
"minLength": 1,
"maxLength": 50,
"description": "Short name (required by ClickTime)."
},
"client_number": {
"description": "Client number (up to 50 characters).",
"type": "string",
"minLength": 1,
"maxLength": 50
},
"notes": {
"description": "Notes.",
"type": "string",
"maxLength": 2000
},
"is_active": {
"description": "Active (default true).",
"type": "boolean"
}
},
"required": [
"name",
"short_name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡clicktime_create_job(client_id, job_number, name, start_date, end_date, ...)
WRITE: create a job (project) under a client. Needs an Admin, or a Manager allowed to add jobs. Creates a NEW job each call (not idempotent); check clicktime_list_jobs first to avoid duplicates. POST /Jobs.
入力スキーマ
{
"type": "object",
"properties": {
"client_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$",
"description": "Client id (see clicktime_list_clients)."
},
"job_number": {
"type": "string",
"minLength": 1,
"maxLength": 50,
"description": "Job number, unique within the company (up to 50 characters)."
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 50,
"description": "Job name (up to 50 characters)."
},
"start_date": {
"description": "Start date (yyyy-mm-dd).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"end_date": {
"description": "End date (yyyy-mm-dd).",
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
},
"is_billable": {
"description": "Billable (only when the company sets billability per job).",
"type": "boolean"
},
"notes": {
"description": "Notes.",
"type": "string",
"maxLength": 2000
},
"is_active": {
"description": "Active (default true).",
"type": "boolean"
}
},
"required": [
"client_id",
"job_number",
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}コミュニティ
エビデンス
最近の観測
検証済みバージョンは記録されていませんツール 26 件