solidtime-mcp
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., "@solidtime-mcp log 1.5 hours on the Website Redesign project 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.
solidtime-mcp (Solidtime MCP connector)
MCP connector for a Solidtime instance. It speaks public REST API v1 over stdio and over stateless Streamable HTTP on localhost.
Solidtime is AGPL-3.0 software. Self-host it, or point this connector at your own cloud account. This connector does not grant any right to the Solidtime name, and it does not imply endorsement.
This connector is MIT. It is a BYO-token client. It only calls the public REST API. It is not affiliated with solidtime-io.
The connector covers all 81 operations in solidtime.openapi.json plus the extra client routes in solidtime.client-routes.ts.txt (99 operations, 53 tools). Week copy and timesheet bulk entry are not on the public REST API, so they are not tools. Project and task estimates use estimated_time in seconds.
Setup
npm install
npm run ci
npm start
npm run start:httpnpm start speaks stdio. npm run start:http serves Streamable HTTP at http://127.0.0.1:3000/mcp and GET /health. HTTP mode has no authentication. Keep it on localhost.
Create a personal API token in Solidtime under Profile settings, Create API Token. The connector sends it as Authorization: Bearer <token> and never prints it.
{
"mcpServers": {
"solidtime": {
"command": "node",
"args": ["/workspace/connectors/solidtime/dist/index.js"],
"env": {
"SOLIDTIME_URL": "http://127.0.0.1:8088",
"SOLIDTIME_API_TOKEN": "...",
"SOLIDTIME_ORGANIZATION_ID": "...",
"SOLIDTIME_ALLOW_WRITES": "false",
"SOLIDTIME_CONTACT": "you@example.com"
}
}
}
}Cloud accounts use https://app.solidtime.io as SOLIDTIME_URL. A trailing /api is stripped.
Docker (HTTP, no authentication, localhost only):
docker build -t solidtime-mcp .
docker run -p 3000:3000 \
-e SOLIDTIME_URL=http://host.docker.internal:8088 \
-e SOLIDTIME_API_TOKEN=... \
solidtime-mcpDo not put the API token in the image.
Related MCP server: solidtime-mcp-server
Tools
Tool | Call |
|
|
|
|
|
|
|
|
|
|
| resend verification or reset pending email |
| list, create, revoke, delete |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| list, invite, resend, remove |
|
|
|
|
|
|
|
|
|
|
| list, create, update, delete |
| list, create, update, delete |
| list, create, update, delete |
| list, create, update, delete |
| list, get, create, update, delete |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| create a time entry with |
| set |
| list, get, create, update, delete |
|
|
| dashboard chart endpoints |
|
|
|
|
|
|
| get or update. Professional |
| list, get, create, update, delete, duplicate. Professional |
| list, get, create, update, delete, copy, download. Professional |
|
|
member_id is the membership id from solidtime_memberships, not the user id.
billable_rate is cents per hour. Changing it can reprice existing time entries.
When no timer is running, solidtime_timer_active returns { data: null, active: false }.
Professional invoice routes that are missing on the instance return a not-available error.
Environment
Variable | Default | Role |
|
| Instance origin. No userinfo, query, or hash. A trailing |
| unset | Required for an upstream call. At least 8 characters. Never printed |
| unset | Optional org UUID. Auto-detected when the user has exactly one membership |
| off | The literal |
|
| Contact inside the User-Agent. Must not contain the token |
|
| Local sliding-window cap |
|
| TTL for successful reads. |
|
| Upstream timeout |
|
|
|
|
| HTTP listen port |
Invalid values are reported by field name and issue code. The rejected value is not included.
Safety
A write tool returns a dry-run preview when confirm is omitted. The preview is the method, path, query, and body that would be sent. Secrets are redacted.
confirm must be the boolean true. false and the string "true" are rejected.
When confirm is true and SOLIDTIME_ALLOW_WRITES is not true, the tool still returns the preview, sets blocked to true, and does not call the instance.
Writes include POST, PUT, PATCH, DELETE, timer start and stop, bulk time-entry update and delete, invites, rate changes, import, export, and trial cancel.
Rate-change previews warn that existing time entries can be repriced. Delete and bulk previews warn that the action is irreversible.
The API token is removed from tool results, error text, and logs, including its URL-encoded form. It is refused in the query string, the base URL, the User-Agent, and a JSON request body. access_token, password, and Authorization values are redacted. Absolute server filesystem paths are dropped.
HTTP 401 is [upstream] authentication failed. HTTP 402 is [upstream] with a quota or payment note. HTTP 403 for a missing Professional feature is [upstream] not available on this plan or instance. HTTP 404 is [not-found]. HTTP 422 surfaces validation messages. HTTP 429 is [rate-limit] with Retry-After and the 200/min cap.
HTTP mode has no authentication. Do not expose it beyond localhost.
Licence
Solidtime is AGPL-3.0 (https://github.com/solidtime-io/solidtime). This connector is MIT. It only calls the public REST API. Bring your own token. Not affiliated with solidtime-io.
License
MIT, see LICENSE. This is an independent, unofficial connector and is not endorsed by the Solidtime project or its owners.
The upstream solidtime.openapi.json comes from a AGPL-3.0 project, so it is not shipped here. src/operations.ts was generated from it, and tests fall back to a route-only fixture in test/fixtures/. To regenerate, download the spec from the upstream project into the repo root (it is gitignored) and run node scripts/gen-operations.mjs.
Available Tools
53 toolssolidtime_api_tokensADestructiveIdempotent
API tokens of the current user. action list, create, revoke, delete. Newly created access_token values are redacted. Writes need confirm.
Inputs: action (required), name, confirm, api_token_id.
solidtime_cancel_trialA
Cancel the organization trial. POST .../trial/cancel. Omit confirm for a dry-run.
Inputs: confirm, organization_id.
solidtime_chartsCRead-only
Dashboard charts. action weekly_project_overview, latest_tasks, last_seven_days, latest_team_activity, daily_tracked_hours, total_weekly_time, total_weekly_billable_time, total_weekly_billable_amount, weekly_history.
Inputs: action (required), organization_id.
solidtime_clientsCDestructiveIdempotent
Clients. action list, create, update, delete. Writes need confirm.
Inputs: action (required), name, page, confirm, +4 more.
solidtime_countriesBRead-only
List countries. GET /api/v1/countries. From the app client routes.
Inputs: no named parameters.
solidtime_currenciesBRead-only
List currencies. GET /api/v1/currencies.
Inputs: no named parameters.
solidtime_export_organizationA
Export organization data. POST .../export. Omit confirm for a dry-run.
Inputs: confirm, organization_id.
solidtime_goalsCDestructiveIdempotent
Time goals. action list, get, create, update, delete. Organization goals need the team goals extension. Writes need confirm.
Inputs: action (required), name, type, period, +9 more.
solidtime_importA
Import data into the organization. POST .../import. Omit confirm for a dry-run.
Inputs: data (required), type (required), confirm, organization_id.
solidtime_importersCRead-only
List available importers. GET .../importers.
Inputs: organization_id.
solidtime_invitationsBDestructiveIdempotent
Organization invitations. action list, invite, resend, remove. Writes need confirm.
Inputs: action (required), role, email, confirm, +2 more.
solidtime_invoice_recipientsCDestructiveIdempotent
Invoice recipients. action list, get, create, update, delete, duplicate. Professional feature. Writes need confirm.
Inputs: action (required), name, email, phone, +11 more.
solidtime_invoicesCDestructiveIdempotent
Invoices. action list, get, create, update, delete, copy, download, download_e_invoice. Professional feature. Writes need confirm.
Inputs: action (required), date, page, notes, +19 more.
solidtime_invoice_settingsBIdempotent
Invoice settings. action get or update. Professional feature. Missing plans return a clean not-available error. Writes need confirm.
Inputs: action (required), confirm, seller_name, seller_email, +13 more.
solidtime_meARead-only
Get the authenticated Solidtime user. GET /api/v1/users/me. Authorization Bearer token. Never returns the token.
Inputs: no named parameters.
solidtime_member_invite_placeholderB
Invite a placeholder member to become a real member. POST .../invite-placeholder. Omit confirm for a dry-run.
Inputs: email (required), member_id (required), confirm, organization_id.
solidtime_member_make_placeholderB
Turn a member into a placeholder. POST .../make-placeholder. Omit confirm for a dry-run.
Inputs: member_id (required), confirm, organization_id.
solidtime_member_mergeADestructiveIdempotent
Merge one member into another. POST .../member/{member}/merge-into. Irreversible. Omit confirm for a dry-run.
Inputs: member_id (required), destination_member_id (required), confirm, organization_id.
solidtime_member_removeADestructiveIdempotent
Remove a member. DELETE .../members/{member}. Irreversible. Omit confirm for a dry-run.
Inputs: member_id (required), confirm, organization_id.
solidtime_membershipsARead-only
List organization memberships of the authenticated user. GET /api/v1/users/me/memberships. Used to auto-detect SOLIDTIME_ORGANIZATION_ID.
Inputs: no named parameters.
solidtime_members_listCRead-only
List organization members. GET /api/v1/organizations/{organization}/members.
Inputs: organization_id.
solidtime_member_updateAIdempotent
Update a member role or billable rate. PUT .../members/{member}. Rate changes can reprice past entries. Omit confirm for a dry-run.
Inputs: member_id (required), role, confirm, billable_rate, +1 more.
solidtime_organization_createB
Create an organization. POST /api/v1/organizations. Omit confirm for a dry-run.
Inputs: name (required), confirm.
solidtime_organization_deleteADestructiveIdempotent
Delete an organization. DELETE /api/v1/organizations/{organization}. Irreversible. Omit confirm for a dry-run.
Inputs: confirm, password, organization_id.
solidtime_organization_getBRead-only
Get an organization. GET /api/v1/organizations/{organization}. organization_id is optional when SOLIDTIME_ORGANIZATION_ID is set.
Inputs: organization_id.
solidtime_organization_updateAIdempotent
Update an organization. PUT /api/v1/organizations/{organization}. Changing billable_rate can reprice past entries. Omit confirm for a dry-run.
Inputs: name, confirm, currency, billable_rate, +5 more.
solidtime_project_createC
Create a project. POST .../projects. name, color, is_billable, and client_id are required. estimated_time is the project estimate in seconds. Omit confirm for a dry-run.
Inputs: name (required), color (required), client_id (required), is_billable (required), +5 more.
solidtime_project_deleteADestructiveIdempotent
Delete a project. DELETE .../projects/{project}. Irreversible. Omit confirm for a dry-run.
Inputs: project_id (required), confirm, organization_id.
solidtime_project_getCRead-only
Get one project. GET .../projects/{project}.
Inputs: project_id (required), organization_id.
solidtime_project_membersCDestructiveIdempotent
Project members. action list, create, update, delete. Rate fields can reprice past entries. Writes need confirm.
Inputs: action (required), confirm, member_id, project_id, +3 more.
solidtime_projects_listBRead-only
List projects visible to the current user. GET .../projects. Optional page and archived.
Inputs: page, archived, organization_id.
solidtime_project_updateAIdempotent
Update a project. PUT .../projects/{project}. Billable rate changes can reprice past entries. Omit confirm for a dry-run.
Inputs: name (required), color (required), client_id (required), project_id (required), +7 more.
solidtime_public_reportARead-only
Get a public report by share secret. GET /api/v1/public/reports with X-Api-Key set to the hash fragment of shareable_link. Auth is optional.
Inputs: share (required).
solidtime_reportsCDestructiveIdempotent
Saved reports. action list, get, create, update, delete. Public share uses is_public. Writes need confirm.
Inputs: action (required), name, confirm, is_public, +21 more.
solidtime_tagsCDestructiveIdempotent
Tags. action list, create, update, delete. Writes need confirm.
Inputs: action (required), name, tag_id, confirm, +1 more.
solidtime_tasksCDestructiveIdempotent
Tasks. action list, create, update, delete. estimated_time is the task estimate in seconds. Writes need confirm.
Inputs: action (required), done, name, confirm, +5 more.
solidtime_time_entries_aggregateCRead-only
Aggregate time entries. GET .../time-entries/aggregate. Optional group and sub_group.
Inputs: end, type, group, start, +14 more.
solidtime_time_entries_aggregate_exportCRead-only
Export aggregated time entries. GET .../time-entries/aggregate/export. format, group, sub_group, history_group, start, and end required.
Inputs: group (required), format (required), sub_group (required), history_group (required), +16 more.
solidtime_time_entries_bulk_deleteADestructiveIdempotent
Delete many time entries. DELETE .../time-entries?ids[]. Irreversible. Omit confirm for a dry-run.
Inputs: ids (required), confirm, organization_id.
solidtime_time_entries_bulk_updateBIdempotent
Update many time entries. PATCH .../time-entries. Irreversible for the listed ids. Omit confirm for a dry-run.
Inputs: ids (required), tags, type, confirm, +6 more.
solidtime_time_entries_exportCRead-only
Export time entries. GET .../time-entries/export. format csv, pdf, xlsx, or ods. start and end required by the API.
Inputs: format (required), end, type, limit, +14 more.
solidtime_time_entries_listBRead-only
List time entries. GET .../time-entries. Filter by member, project, client, tag, task, start, end, active, billable, type.
Inputs: end, type, limit, start, +14 more.
solidtime_time_entry_createB
Create a time entry. POST .../time-entries. Omit end to start a timer. member_id is a membership id. Omit confirm for a dry-run.
Inputs: start (required), billable (required), member_id (required), end, +7 more.
solidtime_time_entry_deleteADestructiveIdempotent
Delete a time entry. DELETE .../time-entries/{timeEntry}. Irreversible. Omit confirm for a dry-run.
Inputs: time_entry_id (required), confirm, organization_id.
solidtime_time_entry_updateBIdempotent
Update a time entry. PUT .../time-entries/{timeEntry}. Set end to stop a running timer. Omit confirm for a dry-run.
Inputs: time_entry_id (required), end, tags, type, +8 more.
solidtime_timer_activeARead-only
Get the active timer of the authenticated user. GET /api/v1/users/me/time-entries/active.
Inputs: no named parameters.
solidtime_timer_startB
Start a timer by creating a time entry with end=null. POST .../time-entries. Omit confirm for a dry-run.
Inputs: billable (required), member_id (required), tags, type, +6 more.
solidtime_timer_stopAIdempotent
Stop a running timer by setting end. PUT .../time-entries/{timeEntry}. Defaults to the active entry. Omit confirm for a dry-run.
Inputs: end, confirm, time_entry_id, organization_id.
solidtime_time_zonesBRead-only
List time zones. GET /api/v1/time-zones.
Inputs: no named parameters.
solidtime_user_deleteADestructiveIdempotent
Delete a user. DELETE /api/v1/users/{user}. Irreversible. Omit confirm for a dry-run.
Inputs: user_id (required), confirm, password.
solidtime_user_emailC
Pending email helpers. action resend_verification or reset_pending. Writes need confirm.
Inputs: action (required), user_id (required), confirm.
solidtime_user_set_organizationAIdempotent
Set the current organization. PUT /api/v1/users/me/current-organization. Omit confirm for a dry-run.
Inputs: confirm, organization_id.
solidtime_user_updateBIdempotent
Update the authenticated user. PUT /api/v1/users/{user}. Omit confirm for a dry-run.
Inputs: user_id (required), name, email, confirm, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 53 tools
Most tool families are separated by clear resources, but several pairs overlap significantly: timer_start vs time_entry_create, timer_stop vs time_entry_update, and members_list vs memberships vs member_* operations. Generic action-based tools also sit alongside dedicated CRUD tools, so an agent must read descriptions carefully to choose correctly.
All tools use snake_case with the solidtime_ prefix, but the naming convention is mixed: some are verb_noun (project_create, time_entry_delete), while many are noun-only action bundles (tags, clients, tasks, reports, invoices). Plural/singular forms are also inconsistent, such as projects_list versus project_get.
With 53 tools, the surface is very large for a single MCP server, even one covering a full time-tracking product. Many domains are represented through both dedicated CRUD tools and generic action-based tools, which likely inflates the count and increases selection burden.
Coverage is broad and deep across the domain: organizations, users, members, projects, tasks, clients, tags, time entries, timers, reports, invoices, charts, import/export, and metadata lookups. CRUD/lifecycle operations are present for the main resources, with few obvious dead ends.
Maintenance
Related MCP Connectors
Start and stop timers, log time entries, and read projects, tasks and time entries in solidtime.
timesheet.io MCP server - manage timers, projects, tasks and reports
Manage Timequip projects, tasks, comments, members, and dashboards through MCP.
MCP server for MOCO business software: time tracking, projects, budgets, and invoicing via API
Related MCP Servers
- AlicenseAqualityCmaintenanceOfficial MCP server for Timebook (usetimebook.com) — time tracking, invoicing, and bookkeeping for freelancers and solo LLCs. Manage clients and projects, start/stop timers, and log, update, and delete time entries. Stdio via the @squidcode/timebook npm CLI; a hosted OAuth endpoint also exists at https://usetimebook.com/mcp.12116 npm2MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for SolidTime — the open-source time tracking app. Enables start/stop timers, manage time entries, projects, clients, tags, and tasks directly from MCP-compatible clients.3MIT
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients to manage Toggl Track time entries, timers, projects, clients, tags, and reports through a self-hosted stdio server.144 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to interact with the Crewmeister API over local stdio, covering operations for members, teams, time tracking, salary exports, and related platform resources.Apache 2.0