TimeIQ MCP Server
The TimeIQ MCP Server enables AI agents (e.g., Claude Desktop, Cursor, Hermes) to manage and automate the full spectrum of TimeIQ time tracking operations. Here's what you can do:
Time Tracking & Timers – Create, update, and delete time entries (by start/end time or duration); bulk update/delete entries; start, stop, cancel, and update running stopwatch timers.
Projects & Clients – List, create, update, delete, archive, and re-activate projects and clients; bulk update multiple projects at once.
People & Capacity – View your own profile/permissions (whoami); manage team members (list, create, update, archive, delete — Admin only); get/set required working capacity; update personal preferences.
Reports & Analytics – Generate standard, classic, custom, payroll, and period summary reports; produce detailed time/expense reports; identify missing or incomplete time entries; search across all time and expense entries; view recent activity feeds.
Expenses – Create, update, and delete expense entries (bulk supported); manage expense types and categories (create, update, archive, delete).
Services – Manage billable services and service categories (list, create, update, archive, delete).
Timesheets & Approvals – List, retrieve, and submit timesheets; approve or decline timesheets (Manager/Admin); find timesheets with issues; send approval reminders.
Invoices – List, create, update, and delete invoices; mark as paid/unpaid/written-off; manage line items; send invoices.
Notifications – Fetch and dismiss active notifications; trigger missing-time and timesheet-approval email reminders.
System Settings – Retrieve and update tenant-wide preferences and timezone settings.
Safety Features – A dry_run mode simulates mutating operations before execution; a bulk action gate requires confirmation for operations on 50+ records.
Exposed Resources – Read-only access to JSON schemas for primary entities, the TimeIQ endpoint specification, and a snapshot of the acting user's profile and permissions.
Provides Slack member ID mapping, allowing secure linking of Slack user IDs to TimeIQ user accounts for enforcing user boundaries.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@TimeIQ MCP Server show my time entries for today"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
TimeIQ Model Context Protocol (MCP) Server
Version 1.3 Created by Timothy Maximilian Scherman (www.timothyscherman.de / www.schild-roth.com) with the purpose of making agency life in the service and service-business area a bit easier, and equipping own AI agents with the ability to create time entries as well as automatically adding regularly recurring items via cron jobs.
A production-ready, fully anonymized Model Context Protocol (MCP) server for TimeIQ time tracking. It provides a standard integration pattern that allows LLM agents (like Claude Desktop, Cursor, or custom gateway agents running on Hermes) to view and manage time entries, projects, clients, reports, invoices, expenses, services, and timesheets via a secure stdio transport.
🚀 Key Features
Anonymized & Secure by Design: Zero hardcoded credentials or branding (no mentions of internal subdomains, private domains, or local credentials).
Interactive Setup Wizard: Run
npx timeiq-mcp setupto automatically generate all env maps, define Slack admins/coworkers interactively, and get copy-paste ready config snippets.Safe-by-Default (Dry-Run): Defaults to
TIMEIQ_DRY_RUN=trueto prevent agents from inadvertently creating, modifying, or deleting entries. All modification requests describe the intended action without executing it.Bulk Action Gate: Forces safety confirmation for multi-record operations.
Complete Reverse-Engineered Coverage: Exposes 50+ tools and 3 read-only resources spanning the entire TimeIQ SPA API.
In-Memory Session Security: Employs an in-memory session cookie jar (zero tokens or cookies are persisted to disk).
Robust Timezone & Input Handling: Strict date validation (prevents JS calendar rollover bugs like
2026-02-30silently resolving toMarch 2nd) and automatic snake_case slugifiers that convert names with German diacritics and umlauts (e.g.,ä→ae,ß→ss).Slack Member ID Mapping & Security: Supports the
TIMEIQ_SLACK_MAPenvironment variable to securely map Slack user IDs directly to individual coworker emails, ensuring hard user-level data ownership and action boundaries.
Related MCP server: Calq MCP
🤖 AI Agent Compatibility & Query Examples
🧠 Primarily Built for Hermes (Zweibot)
This MCP setup was primarily designed for integration with the Hermes agent (Zweibot). It runs flawlessly on your remote VPS container and enables frictionless, real-time time tracking and project management directly via Slack.
Universal MCP Compatibility: Because this server fully conforms to the Model Context Protocol (MCP) specification, any other AI assistant or client (such as Claude Desktop, Cursor, Cline, Windsurf, or Cloud Coworker) can integrate and work with it immediately out of the box with zero custom adjustments.
💬 Practical Query Examples (Prompts) for the AI
Here are concrete, real-world examples of natural language prompts you can give to your AI coworker (e.g. Hermes in Slack or Claude in Claude Desktop/Cursor), along with the corresponding MCP tools mapped under the hood:
1. Time Tracking
Query: “Please book 15 minutes today on the project '[Client Name] - SEO monatlich' with the description: Developing content strategy.”
MCP Tool:
timeiq_time_create(usingstart_timeandend_timeordurationstyle).
Query: “I worked on the website today from 10:00 AM to 11:30 AM. Please log that time.”
MCP Tool:
timeiq_time_create(automatically parses and converts the duration to 90 minutes).
Query: “Delete my time entry with the ID 44088.”
MCP Tool:
timeiq_time_delete.
2. Running Stopwatches (Timer)
Query: “Start a stopwatch for the 'Marketing Campaign' project and set the topic to 'Create social media post'.”
MCP Tool:
timeiq_timer_start.
Query: “How long has my current stopwatch been running and what am I working on?”
MCP Tool:
timeiq_timer_get.
Query: “Change the notes of my active timer to 'Review round with the client'.”
MCP Tool:
timeiq_timer_update(routes a flat PUT payload to the correct/actions/updateTimeEntryAPI endpoint).
Query: “I'm finished, please stop the stopwatch and save the time.”
MCP Tool:
timeiq_timer_stop(stops the running timer and persists the time entry).
Query: “Cancel the active stopwatch and discard the time.”
MCP Tool:
timeiq_timer_cancel(deletes the running stopwatch without creating any time entry).
3. Managing Projects & Clients
Query: “Show me a list of all our active projects.”
MCP Tool:
timeiq_project_list(filtered byactive).
Query: “Can you please archive the 'Insurance Directory' project?”
MCP Tool:
timeiq_project_archive(safely looks up the project ID and archives it via bulk-routing).
Query: “Create a new client named 'ACME GmbH' and set up a project called 'Web Design 2026' for them.”
MCP Tools:
timeiq_client_createfollowed bytimeiq_project_create.
4. Reports & Analysis
Query: “Generate a report for this week and show me the total hours booked.”
MCP Tool:
timeiq_report_standard(returns high-level summary KPIs).
Query: “Search for all my time entries logged today.”
MCP Tool:
timeiq_report_search_time(executes search utilizing double-nested parameters).
Query: “Are there any coworkers who have not completed their required hours this week?”
MCP Tool:
timeiq_report_missing_time.
5. Invoices & Expenses
Query: “Show me all invoices for '[Client Name]' from this year.”
MCP Tool:
timeiq_invoice_list_for_client.
Query: “Log a new expense of 45 € for 'Train Ticket' on the project 'SEO monatlich'.”
MCP Tool:
timeiq_expense_create.
Query: “Mark invoice number RE-2026-004 as fully paid.”
MCP Tool:
timeiq_invoice_mark_paid(resolved dynamically usingtimeiq_invoice_get_by_number).
6. Timesheets & System Info
Query: “Submit my timesheet for the current period for approval.”
MCP Tool:
timeiq_timesheet_submit(automatically fetches the active period and submits it).
Query: “Who am I in TimeIQ and what are my permissions?”
MCP Tool:
timeiq_whoami(retrieves full profile details from/api/people/me).
🛠️ Installation & Setup
Requirements
Node.js >= 20.0.0
⚡ Quick Interactive Setup Wizard (Recommended)
To configure the server, map Slack User IDs to emails, and generate config blocks instantly, run the zero-dependency interactive setup CLI wizard:
npm run setupor directly via:
npx timeiq-mcp setupThe wizard will guide you through:
Entering your TimeIQ Tenant subdomain, email, and password.
Specifying the Admin Slack User ID (which maps to your admin email).
Sequentially adding as many coworker Slack User IDs and corresponding TimeIQ Emails as you want.
Setting the default safety mode (Dry-run).
Once completed, it will automatically:
Create/update a local
.envfile in the working directory.Render copy-paste-ready config blocks for both Claude Desktop and Hermes (config.yaml).
Display a clear role/user mapping table for verification.
1. Environment Variables
Configure the following environment variables. The server will validate them on startup using Zod:
Variable | Type | Default | Description |
|
| Required | Your TimeIQ tenant subdomain (e.g., |
|
| Required | The acting user's email address (or Admin service account). |
|
| Required | The acting user's password. |
|
|
| Optional. A JSON mapping of Slack user IDs to TimeIQ emails (e.g. |
|
|
| Safety Mode. If |
💻 Configuration
A. Claude Desktop
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"timeiq-mcp": {
"command": "npx",
"args": ["-y", "timeiq-mcp"],
"env": {
"TIMEIQ_TENANT": "your-tenant",
"TIMEIQ_EMAIL": "your-email@example.com",
"TIMEIQ_PASSWORD": "your-password",
"TIMEIQ_DRY_RUN": "true"
}
}
}
}B. Cursor
Go to Settings > Features > MCP.
Click + Add New MCP Server.
Fill in the details:
Name:
timeiq-mcpType:
commandCommand:
env TIMEIQ_TENANT="your-tenant" TIMEIQ_EMAIL="your-email@example.com" TIMEIQ_PASSWORD="your-password" TIMEIQ_DRY_RUN="true" npx -y timeiq-mcp
C. Hermes / Remote Gateway (Honcho / VPS)
To integrate the server with remote gateway bots, register the tool inside the bots' local config.yaml and boot:
mcp:
servers:
timeiq-mcp:
command: "npx"
args: ["-y", "timeiq-mcp"]
env:
TIMEIQ_TENANT: "your-tenant"
TIMEIQ_EMAIL: "admin-account@example.com"
TIMEIQ_PASSWORD: "secure-password"
TIMEIQ_DRY_RUN: "false" # Set to false to allow actual actions
TIMEIQ_SLACK_MAP: '{"U12345678": "cara@example.com", "U87654321": "emily@example.com"}'🛠️ Exposed MCP Tools
The server exposes modular tools mapped across 10 distinct domains:
📅 1. Time & Timers (time.ts)
timeiq_time_list_me: List acting user's time entries in a date range. Defaults to today.timeiq_time_list_person: Admin only. Retrieve time entries for another user.timeiq_time_create: Create a time entry (supports both start/end time and duration style).timeiq_time_create_overbook: Create a time entry with budget warnings.timeiq_time_update: Update a single time entry using automatic changeset comparison.timeiq_time_delete: Delete a single time entry.timeiq_time_delete_many: Delete multiple time entries by ID list.timeiq_time_update_many: Apply bulk updates to a list of time entries.timeiq_time_batch: Week-grid-style batch updates.timeiq_timer_get: Get currently running stopwatch.timeiq_timer_start: Start a new running timer.timeiq_timer_stop: Stop running timer and convert to a time entry.timeiq_timer_cancel: Cancel active timer.timeiq_timer_update: Update active timer notes/project.timeiq_timer_update_entry: Update underlying entry of active timer.
🏢 2. Projects & Clients (projects.ts)
timeiq_project_list: List projects. Can filter by active, archived, managed, or managed_archived.timeiq_project_get: Get single project details by slug.timeiq_project_create: Create a project (auto-slugifies names).timeiq_project_update: Update project attributes.timeiq_project_update_many: Update multiple projects in one call.timeiq_project_delete: Delete a project.timeiq_project_archive: Archive a project.timeiq_project_activate: Re-activate an archived project.timeiq_client_list: List clients. Can filter by active, archived, managed, or managed_archived.timeiq_client_get: Get client details by slug.timeiq_client_create: Create client.timeiq_client_update: Update client.timeiq_client_delete: Delete client.timeiq_client_archive: Archive a client.timeiq_client_activate: Re-activate an archived client.
👥 3. People & Capacity (people.ts)
timeiq_whoami: Get profile and settings of currently authenticated acting user.timeiq_person_list: List team members. Can filter by active, archived, managed, or managed_archived.timeiq_person_get: Get single team member by slug.timeiq_person_create: Create new person (Admin only).timeiq_person_update: Update person details (Admin only).timeiq_person_delete: Delete a person (Admin only).timeiq_person_archive: Archive a coworker.timeiq_person_activate: Re-activate a coworker.timeiq_person_update_preferences: Update own preferences.timeiq_person_required_time_get: Get capacity settings for a person.timeiq_person_required_time_set: Set capacity values for a person.
📊 4. Reports (reports.ts)
timeiq_report_standard: Overview report (summary card data).timeiq_report_standard_time: Standard report time-tab entries.timeiq_report_standard_expenses: Standard report expenses.timeiq_report_time: Time summary totals & group-by breakdowns.timeiq_report_time_detail: Detailed time-entry report list.timeiq_report_expenses: Summary expense report.timeiq_report_expenses_detail: Detailed expense report list.timeiq_report_classic: Classic summary report.timeiq_report_classic_time: Classic time report.timeiq_report_custom: Custom report with custom parameters.timeiq_report_period: Period-aligned timesheet report.timeiq_report_payroll: Payroll summaries for staff.timeiq_report_recent_activity: Feed of latest changes.timeiq_report_missing_time: Identify people missing capacity entries.timeiq_report_incomplete_time: Identify people with incomplete times.timeiq_report_search_time: Search across time entries.timeiq_report_search_expenses: Search across expense entries.
💼 5. Expenses (expenses.ts)
timeiq_expense_list_me: List expense entries for the acting user.timeiq_expense_list_person: List expense entries for another user.timeiq_expense_create: Log new expense (travel, software, etc.).timeiq_expense_update: Update logged expense.timeiq_expense_delete: Delete expense.timeiq_expense_delete_many: Delete multiple expenses.timeiq_expense_update_many: Apply updates to multiple expenses.timeiq_expense_type_list: List expense types.timeiq_expense_type_get: Get single expense type by slug.timeiq_expense_type_create: Create expense type.timeiq_expense_type_update: Update expense type.timeiq_expense_type_delete: Delete expense type.timeiq_expense_type_archive: Archive an expense type.timeiq_expense_type_activate: Re-activate an expense type.timeiq_expense_category_list: List expense categories.timeiq_expense_category_create: Create expense category.timeiq_expense_category_update: Update expense category.timeiq_expense_category_delete: Delete expense category.timeiq_expense_category_archive: Archive an expense category.timeiq_expense_category_activate: Re-activate an expense category.
🏷️ 6. Services (services.ts)
timeiq_service_list: List billable services (tasks).timeiq_service_create: Create billable service.timeiq_service_update: Update service.timeiq_service_delete: Delete service.timeiq_service_archive: Archive a service.timeiq_service_activate: Re-activate a service.timeiq_service_category_list: List service categories.timeiq_service_category_create: Create service category.timeiq_service_category_update: Update service category.timeiq_service_category_delete: Delete service category.timeiq_service_category_archive: Archive a service category.timeiq_service_category_activate: Re-activate a service category.
🕒 7. Timesheets & Approvals (timesheets.ts)
timeiq_timesheet_period_list: List all timesheet periods.timeiq_timesheet_period_by_date: Get the timesheet period covering a specific date.timeiq_timesheet_period_get: Get details for a single timesheet period by ID.timeiq_timesheet_list: List timesheets for the acting user.timeiq_timesheet_get: Get details for a single timesheet by ID.timeiq_timesheet_by_date: Get the timesheet covering a specific date.timeiq_timesheet_with_issues: List timesheets flagged with issues.timeiq_timesheet_neighbors: Fetch neighbor timesheets.timeiq_timesheet_submit: Submit a timesheet for review and approval.timeiq_timesheet_approve: Approve a submitted timesheet (Manager/Admin only).timeiq_timesheet_decline: Decline/reject a submitted timesheet (Manager/Admin only).timeiq_timesheet_send_reminder: Trigger a missing timesheet submission email reminder.
🧾 8. Invoices (invoices.ts)
timeiq_invoice_list: List all invoices, optionally filtered by date range.timeiq_invoice_list_for_client: List all invoices for a specific client.timeiq_invoice_get: Get details of a single invoice by its ID.timeiq_invoice_get_by_number: Get a single invoice by its alphanumeric invoice number.timeiq_invoice_create: Create a new draft invoice.timeiq_invoice_update: Update an invoice (e.g. details, dates, comments).timeiq_invoice_delete: Delete an existing invoice by ID.timeiq_invoice_mark_paid: Mark an invoice status as fully paid.timeiq_invoice_mark_unpaid: Mark a paid or drafted invoice status as unpaid.timeiq_invoice_mark_written_off: Mark an invoice status as written-off.timeiq_invoice_send: Trigger the invoice-send email.timeiq_invoice_export: Get invoice export/PDF compile details.timeiq_lineitem_add: Add a new line item details row to an existing invoice.timeiq_lineitem_update: Update a single line item details row on an invoice.timeiq_lineitem_delete: Remove a line item details row from an invoice.
🔔 9. Notifications & Reminders (notifications.ts)
timeiq_notifications_list: Fetch active notifications.timeiq_notifications_dismiss: Dismiss notification by ID.timeiq_notifications_remind_missing: Trigger missing-time email reminder to a user.timeiq_notifications_remind_timesheet: Trigger timesheet-approval reminder.
⚙️ 10. System Settings (settings.ts)
timeiq_settings_get: Get tenant-wide preferences.timeiq_settings_update: Update system configuration parameters.timeiq_settings_timezones: Retrieve active timezone choices.
📦 Exposed Resources
The server exposes three read-only resources through standard URI schemes:
timeiq://schemas: Dynamically dumps complete JSON schemas of all primary entities (Person, Client, Project, TimeEntry, Invoice, etc.) derived from strict Zod schemas.timeiq://endpoints: The entire reverse-engineered specification of the TimeIQ HTTP endpoints, allowing the LLM to inspect route constraints and exact payloads.timeiq://me: A snapshot of the currently acting user's profile and permission configuration (cached for 60 seconds).
🔒 Safety & Simulations
When running in Dry-Run mode (TIMEIQ_DRY_RUN=true), any mutating operation returns a simulated response structured identically to the actual API response:
{
"dry_run": true,
"request": {
"method": "POST",
"path": "/api/time",
"body": {
"date": "2026-05-29",
"project_id": 2070,
"duration": 60,
"notes": "Testing the MCP Server safely"
}
}
}🧪 Development
Install dependencies
npm installRun tests
The test suite utilizes Vitest to validate strict dates, slugifiers, and partial changeset generation:
npm run testCompile TypeScript
npm run build📄 License
This project is licensed under the MIT License.
Available Tools
126 toolstimeiq_billing_infoA
Get the current TimeIQ subscription plan and billing credit card details.
Inputs: no named parameters.
timeiq_billing_invoicesB
List all past TimeIQ subscription SaaS billing invoices.
Inputs: no named parameters.
timeiq_client_activateA
Re-activate an archived client (sets isActive to true).
Inputs: slug (required).
timeiq_client_archiveC
Archive an active client (sets isActive to false).
Inputs: slug (required).
timeiq_client_createC
Create a new client.
Inputs: name (required), isActive, dry_run.
timeiq_client_deleteC
Delete an existing client by its slug.
Inputs: slug (required), dry_run.
timeiq_client_getB
Get a single client by their slug.
Inputs: slug (required).
timeiq_client_listA
List clients. Can filter by active, archived, managed, or managed_archived.
Inputs: filter.
timeiq_client_updateB
Update an existing client by their slug with a partial changeset.
Inputs: slug (required), changeset (required), dry_run.
timeiq_expense_category_activateA
Activate a previously archived expense category (sets isActive to true).
Inputs: slug (required).
timeiq_expense_category_archiveC
Archive an expense category (sets isActive to false).
Inputs: slug (required).
timeiq_expense_category_createD
Create a new expense category.
Inputs: name (required), isActive, dry_run.
timeiq_expense_category_deleteC
Delete an existing expense category by its slug.
Inputs: slug (required), dry_run.
timeiq_expense_category_listA
List active expense categories. Optional toggle to list archived instead.
Inputs: archived.
timeiq_expense_category_updateB
Update an existing expense category by its slug with a partial changeset.
Inputs: slug (required), changeset (required), dry_run.
timeiq_expense_createC
Create a new expense entry.
Inputs: date (required), project_id (required), amount (required), notes, +3 more.
timeiq_expense_deleteC
Delete an existing expense entry by ID.
Inputs: id (required), dry_run.
timeiq_expense_delete_manyB
Delete multiple expense entries. Safe-guarded for actions exceeding 50 entries.
Inputs: ids (required), confirm_bulk, dry_run.
timeiq_expense_list_meA
List expense entries for the acting user within a date range.
Inputs: start_date, end_date.
timeiq_expense_list_personA
List expense entries for a specific person by their slug (Admin only).
Inputs: slug (required), start_date (required), end_date (required).
timeiq_expense_type_activateA
Activate a previously archived expense type (sets isActive to true).
Inputs: slug (required).
timeiq_expense_type_archiveB
Archive an expense type (sets isActive to false).
Inputs: slug (required).
timeiq_expense_type_createC
Create a new expense type.
Inputs: name (required), isActive, dry_run.
timeiq_expense_type_deleteC
Delete an existing expense type by its slug.
Inputs: slug (required), dry_run.
timeiq_expense_type_getA
Get a single expense type by its slug.
Inputs: slug (required).
timeiq_expense_type_listA
List active expense types. Optional toggle to list archived types instead.
Inputs: archived.
timeiq_expense_type_updateC
Update an existing expense type by its slug with a partial changeset.
Inputs: slug (required), changeset (required), dry_run.
timeiq_expense_updateB
Update an existing expense entry with a partial changeset.
Inputs: id (required), changeset (required), dry_run.
timeiq_expense_update_manyB
Update multiple expense entries. Safe-guarded for actions exceeding 50 entries.
Inputs: ids (required), changeset (required), confirm_bulk, dry_run.
timeiq_invoice_createC
Create a new draft invoice.
Inputs: client_id (required), invoice_number (required), date, due_date, +2 more.
timeiq_invoice_deleteC
Delete an existing invoice by ID.
Inputs: id (required), dry_run.
timeiq_invoice_exportC
Get invoice export/PDF compile details (Client-side URL tag).
Inputs: id (required).
timeiq_invoice_getB
Get details of a single invoice by its ID.
Inputs: id (required).
timeiq_invoice_get_by_numberB
Get a single invoice by its alphanumeric invoice number.
Inputs: number (required).
timeiq_invoice_listB
List all invoices, optionally filtered by date range.
Inputs: from, to.
timeiq_invoice_list_for_clientA
List all invoices for a specific client within an optional date range.
Inputs: clientId (required), from, to.
timeiq_invoice_mark_paidC
Mark an invoice status as fully paid.
Inputs: id (required), dry_run.
timeiq_invoice_mark_unpaidC
Mark a paid or drafted invoice status as unpaid.
Inputs: id (required), dry_run.
timeiq_invoice_mark_written_offC
Mark an invoice status as written-off/uncollectible.
Inputs: id (required), dry_run.
timeiq_invoice_sendC
Trigger the invoice-send email to the client's email addresses.
Inputs: id (required), dry_run.
timeiq_invoice_updateB
Update an invoice (e.g. details, dates, comments) with a partial changeset.
Inputs: id (required), changeset (required), dry_run.
timeiq_lineitem_addC
Add a new line item details row to an existing invoice.
Inputs: invoice_id (required), description (required), quantity (required), rate (required), +2 more.
timeiq_lineitem_deleteC
Remove a line item details row from an invoice.
Inputs: id (required), dry_run.
timeiq_lineitem_updateC
Update a single line item details row on an invoice.
Inputs: id (required), changeset (required), dry_run.
timeiq_notification_dismissB
Dismiss/acknowledge a single notification by ID.
Inputs: id (required), dry_run.
timeiq_notification_listB
List notifications for a team member within a date range.
Inputs: personId (required), start_date (required), end_date (required).
timeiq_notification_send_missing_time_reminderC
Trigger a daily missing-time notification reminder email for a team member.
Inputs: personId (required), dry_run.
timeiq_person_activateB
Re-activate an archived team member (sets isActive to true).
Inputs: slug (required).
timeiq_person_archiveA
Archive a team member (sets isActive to false).
Inputs: slug (required).
timeiq_person_createC
Create a new team member record (Admin only).
Inputs: firstName (required), lastName (required), email (required), timeZone, +3 more.
timeiq_person_deleteA
Delete a team member record by their slug (Admin only).
Inputs: slug (required), dry_run.
timeiq_person_getB
Get a single team member's record by their slug.
Inputs: slug (required).
timeiq_person_listA
List team members. Can filter by active, archived, managed, or managed_archived.
Inputs: filter.
timeiq_person_required_time_getB
Retrieve required daily working capacity (in seconds) for a person in a date range.
Inputs: personId (required), start_date (required), end_date (required).
timeiq_person_required_time_setC
Set or update a person's required working capacity (in seconds) for a date.
Inputs: personId (required), date (required), required_seconds (required), dry_run.
timeiq_person_updateB
Update an existing team member's record by their slug (Admin only).
Inputs: slug (required), changeset (required), dry_run.
timeiq_person_update_preferencesB
Update the acting user's own frontend preferences.
Inputs: preferences (required), dry_run.
timeiq_project_activateA
Re-activate an archived project (sets active to true).
Inputs: slug (required).
timeiq_project_archiveC
Archive an active project (sets active to false).
Inputs: slug (required).
timeiq_project_createC
Create a new project linked to a client.
Inputs: name (required), client_id (required), is_billable, budget_type, +3 more.
timeiq_project_deleteC
Delete an existing project by its slug.
Inputs: slug (required), dry_run.
timeiq_project_getC
Get a single project by its slug.
Inputs: slug (required).
timeiq_project_listA
List projects. Can filter by active, archived, managed, or managed_archived.
Inputs: filter.
timeiq_project_updateB
Update an existing project by its slug with a partial changeset.
Inputs: slug (required), changeset (required), dry_run.
timeiq_project_update_manyA
Bulk update multiple projects. Safe-guarded for actions exceeding 50 entries.
Inputs: ids (required), changeset (required), confirm_bulk, dry_run.
timeiq_report_classicC
Generate classic summary report (legacy layout).
Inputs: start_date (required), end_date (required), clients, projects, +3 more.
timeiq_report_classic_timeC
Generate classic time report.
Inputs: start_date (required), end_date (required), clients, projects, +3 more.
timeiq_report_customD
Generate custom report utilizing flexible filter extras.
Inputs: start_date (required), end_date (required), clients, projects, +3 more.
timeiq_report_expensesC
Generate summary expense report.
Inputs: start_date (required), end_date (required), clients, projects, +3 more.
timeiq_report_expenses_detailC
Generate detailed expense-entry report (items list).
Inputs: start_date (required), end_date (required), clients, projects, +3 more.
timeiq_report_incomplete_timeC
Identify people with incomplete, un-submitted, or open timers.
Inputs: start_date (required), end_date (required), clients, projects, +3 more.
timeiq_report_missing_timeC
Identify people with missing required working hours (capacity gaps).
Inputs: start_date (required), end_date (required), clients, projects, +3 more.
timeiq_report_payrollC
Generate payroll report (reconciled hours, rates, costs).
Inputs: start_date (required), end_date (required), clients, projects, +3 more.
timeiq_report_periodC
Generate report aligned to timesheet periods.
Inputs: start_date (required), end_date (required), clients, projects, +3 more.
timeiq_report_recent_activityC
Generate feed showing recent activity/logs by project or person.
Inputs: start_date (required), end_date (required), clients, projects, +3 more.
timeiq_report_search_expensesC
Perform filter search across all expense entries.
Inputs: start_date (required), end_date (required), clients, projects, +3 more.
timeiq_report_search_timeC
Perform filter search across all time entries.
Inputs: start_date (required), end_date (required), clients, projects, +3 more.
timeiq_report_standardC
Generate standard summary report overview.
Inputs: start_date (required), end_date (required), clients, projects, +3 more.
timeiq_report_standard_expensesC
Generate standard report - expenses totals.
Inputs: start_date (required), end_date (required), clients, projects, +3 more.
timeiq_report_standard_timeC
Generate standard report - time totals and items.
Inputs: start_date (required), end_date (required), clients, projects, +3 more.
timeiq_report_timeC
Generate time report (totals & project breakdowns).
Inputs: start_date (required), end_date (required), clients, projects, +3 more.
timeiq_report_time_detailC
Generate detailed time-entry report (specific items list).
Inputs: start_date (required), end_date (required), clients, projects, +3 more.
timeiq_service_activateB
Activate a previously archived service (sets isActive to true).
Inputs: slug (required).
timeiq_service_archiveB
Archive a service (sets isActive to false).
Inputs: slug (required).
timeiq_service_category_activateA
Activate a previously archived service category (sets isActive to true).
Inputs: slug (required).
timeiq_service_category_archiveB
Archive a service category (sets isActive to false).
Inputs: slug (required).
timeiq_service_category_createC
Create a new service category.
Inputs: name (required), isActive, dry_run.
timeiq_service_category_deleteC
Delete an existing service category by its slug.
Inputs: slug (required), dry_run.
timeiq_service_category_listA
List active service categories. Optional toggle to list archived categories instead.
Inputs: archived.
timeiq_service_category_updateB
Update an existing service category by its slug with a partial changeset.
Inputs: slug (required), changeset (required), dry_run.
timeiq_service_createC
Create a new service (task type).
Inputs: name (required), isBillable, isActive, service_category_id, +1 more.
timeiq_service_deleteC
Delete an existing service by its slug.
Inputs: slug (required), dry_run.
timeiq_service_listA
List active services (task types). Optional toggle to list archived services instead.
Inputs: archived.
timeiq_service_updateB
Update an existing service by its slug with a partial changeset.
Inputs: slug (required), changeset (required), dry_run.
timeiq_settings_getA
Get tenant-wide settings (features, billing defaults, locking rules).
Inputs: no named parameters.
timeiq_settings_timezonesA
List all standard IANA timezones supported by TimeIQ.
Inputs: no named parameters.
timeiq_settings_updateB
Update tenant-wide configuration settings with a partial changeset (Admin only).
Inputs: changeset (required), dry_run.
timeiq_time_batchC
Perform batch week-grid row changesets (week grid editor).
Inputs: date (required), batch (required), dry_run, requesting_slack_id.
timeiq_time_createC
Create a new time entry. Must provide either a start_time/end_time pair OR a duration (in minutes).
Inputs: date (required), project_id (required), start_time, end_time, +7 more.
timeiq_time_create_overbookB
Create a time entry that might exceed the project budget, and get immediate budget usage feedback.
Inputs: date (required), project_id (required), start_time, end_time, +7 more.
timeiq_time_deleteB
Delete an existing time entry by ID.
Inputs: id (required), dry_run, requesting_slack_id.
timeiq_time_delete_manyB
Delete multiple time entries at once. Safe-guarded for actions exceeding 50 entries.
Inputs: ids (required), confirm_bulk, dry_run, requesting_slack_id.
timeiq_time_list_meA
List time entries for the acting user within a given date range. Defaults to today.
Inputs: start_date, end_date, requesting_slack_id.
timeiq_time_list_personA
List time entries for a specific person by their slug within a date range (Admin only).
Inputs: slug (required), start_date (required), end_date (required).
timeiq_timer_cancelC
Cancel the currently running stopwatch timer without creating a time entry.
Inputs: dry_run, requesting_slack_id.
timeiq_timer_getC
Retrieve the current running stopwatch timer for the acting user.
Inputs: requesting_slack_id.
timeiq_timer_startC
Start a new stopwatch timer for a project.
Inputs: project_id (required), date, start_time, notes, +5 more.
timeiq_timer_stopC
Stop the currently running stopwatch timer and record the time entry.
Inputs: notes, dry_run, requesting_slack_id.
timeiq_timer_updateC
Update the configuration or start time of an active timer.
Inputs: id (required), changeset (required), dry_run, requesting_slack_id.
timeiq_timer_update_entryC
Update the underlying time entry linked to an active timer.
Inputs: id (required), changeset (required), dry_run, requesting_slack_id.
timeiq_timesheet_approveB
Approve a submitted timesheet (Manager/Admin only).
Inputs: id (required), dry_run.
timeiq_timesheet_by_dateC
Get the timesheet covering a specific date.
Inputs: date (required).
timeiq_timesheet_declineC
Decline/reject a submitted timesheet (Manager/Admin only).
Inputs: id (required), dry_run.
timeiq_timesheet_getB
Get details for a single timesheet by ID.
Inputs: id (required).
timeiq_timesheet_listB
List timesheets for the acting user.
Inputs: no named parameters.
timeiq_timesheet_neighborsB
Fetch neighbor timesheets (previous and next) for a target person and timesheet ID.
Inputs: id (required), personId (required).
timeiq_timesheet_period_by_dateC
Get the timesheet period covering a specific date.
Inputs: date (required).
timeiq_timesheet_period_getB
Get details for a single timesheet period by ID.
Inputs: id (required).
timeiq_timesheet_period_listB
List all timesheet periods.
Inputs: no named parameters.
timeiq_timesheet_send_reminderC
Trigger a missing timesheet submission email reminder for a team member.
Inputs: personId (required), tsId (required), dry_run.
timeiq_timesheet_submitC
Submit a timesheet for review and approval.
Inputs: id (required), dry_run.
timeiq_timesheet_with_issuesA
List all timesheets flagged with issues (e.g. overbooked, missing required time).
Inputs: no named parameters.
timeiq_time_updateC
Update an existing time entry with a partial changeset.
Inputs: id (required), changeset (required), dry_run, requesting_slack_id.
timeiq_time_update_manyC
Update multiple time entries with the same changeset. Safe-guarded for actions exceeding 50 entries.
Inputs: ids (required), changeset (required), confirm_bulk, dry_run, +1 more.
timeiq_urlA
Get the site URL for the tenant domain.
Inputs: no named parameters.
timeiq_whoamiA
Get the profile and settings of the currently authenticated acting user.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 126 tools
Most tools have clear resource+action patterns, making them distinguishable. However, the large number of report tools (e.g., timeiq_report_classic, timeiq_report_custom, timeiq_report_expenses, etc.) are similar in purpose and could cause confusion, reducing the score from perfect.
All tools follow a consistent 'timeiq_<resource>_<action>' naming pattern, with clear noun-verb structure. Even variations like timeiq_timer_start are consistent within their resource group. No mixing of conventions.
With 126 tools, the server is far too large for typical MCP usage. This overwhelms the agent with choices and likely violates best practices. The number is excessive for any single server.
The tool set comprehensively covers the domain of time tracking, invoicing, expense management, projects, clients, and reporting. All expected CRUD operations and workflows are present, with no obvious gaps.
Maintenance
Related MCP Connectors
timesheet.io MCP server - manage timers, projects, tasks and reports
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Privacy-first time tracking for freelancers. EU-hosted, with an MCP server for AI assistants.
MCP server exposing klokin time-tracking operations (employees, time entries, stores) to AI clients.
Related MCP Servers
FlicenseNot gradedqualityFmaintenanceA Model Context Protocol server that provides time tracking integration with TimeCamp, allowing AI assistants to create, retrieve, update, and delete time entries through natural language commands.1-- AlicenseNot gradedqualityDmaintenanceA comprehensive MCP server for time tracking, project management, and AI-powered memory storage using semantic search. It enables users to log time, manage client billing, and capture shared or personal ideas through integrated tools and team collaboration features.1MIT
- AlicenseNot gradedqualityDmaintenanceExposes TimeTracker RX REST API as an MCP server, enabling AI tools like Claude and Cursor to manage time entries, projects, work items, and analytics with a security policy that restricts write operations to owned resources.MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that lets LLMs interact with your Clockify workspace for time-tracking automation and reporting, enabling natural language logging of time entries, querying entries, and generating reports.MIT