solidtime-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | HTTP listen port. | 3000 |
| MCP_TRANSPORT | No | stdio or http. --http forces HTTP. | stdio |
| SOLIDTIME_URL | No | Instance origin. No userinfo, query, or hash. A trailing /api is stripped. | https://app.solidtime.io |
| SOLIDTIME_CONTACT | No | Contact inside the User-Agent. Must not contain the token. | contact@example.com |
| SOLIDTIME_API_TOKEN | Yes | Required for an upstream call. At least 8 characters. Never printed. | |
| SOLIDTIME_PER_MINUTE | No | Local sliding-window cap. | 200 |
| SOLIDTIME_TIMEOUT_MS | No | Upstream timeout. | 20000 |
| SOLIDTIME_ALLOW_WRITES | No | The literal true enables writes. Any other value keeps writes as a blocked preview. | off |
| SOLIDTIME_CACHE_TTL_SEC | No | TTL for successful reads. 0 disables the cache. | 60 |
| SOLIDTIME_ORGANIZATION_ID | No | Optional org UUID. Auto-detected when the user has exactly one membership. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| solidtime_meA | Get the authenticated Solidtime user. GET /api/v1/users/me. Authorization Bearer token. Never returns the token. |
| solidtime_membershipsA | List organization memberships of the authenticated user. GET /api/v1/users/me/memberships. Used to auto-detect SOLIDTIME_ORGANIZATION_ID. |
| solidtime_user_updateB | Update the authenticated user. PUT /api/v1/users/{user}. Omit confirm for a dry-run. |
| solidtime_user_set_organizationA | Set the current organization. PUT /api/v1/users/me/current-organization. Omit confirm for a dry-run. |
| solidtime_user_deleteA | Delete a user. DELETE /api/v1/users/{user}. Irreversible. Omit confirm for a dry-run. |
| solidtime_user_emailC | Pending email helpers. action resend_verification or reset_pending. Writes need confirm. |
| solidtime_api_tokensA | API tokens of the current user. action list, create, revoke, delete. Newly created access_token values are redacted. Writes need confirm. |
| solidtime_countriesB | List countries. GET /api/v1/countries. From the app client routes. |
| solidtime_currenciesB | List currencies. GET /api/v1/currencies. |
| solidtime_time_zonesB | List time zones. GET /api/v1/time-zones. |
| solidtime_organization_getB | Get an organization. GET /api/v1/organizations/{organization}. organization_id is optional when SOLIDTIME_ORGANIZATION_ID is set. |
| solidtime_organization_createB | Create an organization. POST /api/v1/organizations. Omit confirm for a dry-run. |
| solidtime_organization_updateA | Update an organization. PUT /api/v1/organizations/{organization}. Changing billable_rate can reprice past entries. Omit confirm for a dry-run. |
| solidtime_organization_deleteA | Delete an organization. DELETE /api/v1/organizations/{organization}. Irreversible. Omit confirm for a dry-run. |
| solidtime_members_listC | List organization members. GET /api/v1/organizations/{organization}/members. |
| solidtime_member_updateA | Update a member role or billable rate. PUT .../members/{member}. Rate changes can reprice past entries. Omit confirm for a dry-run. |
| solidtime_member_removeA | Remove a member. DELETE .../members/{member}. Irreversible. Omit confirm for a dry-run. |
| solidtime_member_invite_placeholderB | Invite a placeholder member to become a real member. POST .../invite-placeholder. Omit confirm for a dry-run. |
| solidtime_member_make_placeholderB | Turn a member into a placeholder. POST .../make-placeholder. Omit confirm for a dry-run. |
| solidtime_member_mergeA | Merge one member into another. POST .../member/{member}/merge-into. Irreversible. Omit confirm for a dry-run. |
| solidtime_invitationsB | Organization invitations. action list, invite, resend, remove. Writes need confirm. |
| solidtime_projects_listB | List projects visible to the current user. GET .../projects. Optional page and archived. |
| solidtime_project_getC | Get one project. GET .../projects/{project}. |
| 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. |
| solidtime_project_updateA | Update a project. PUT .../projects/{project}. Billable rate changes can reprice past entries. Omit confirm for a dry-run. |
| solidtime_project_deleteA | Delete a project. DELETE .../projects/{project}. Irreversible. Omit confirm for a dry-run. |
| solidtime_project_membersC | Project members. action list, create, update, delete. Rate fields can reprice past entries. Writes need confirm. |
| solidtime_clientsC | Clients. action list, create, update, delete. Writes need confirm. |
| solidtime_tagsC | Tags. action list, create, update, delete. Writes need confirm. |
| solidtime_tasksC | Tasks. action list, create, update, delete. estimated_time is the task estimate in seconds. Writes need confirm. |
| solidtime_goalsC | Time goals. action list, get, create, update, delete. Organization goals need the team goals extension. Writes need confirm. |
| solidtime_time_entries_listB | List time entries. GET .../time-entries. Filter by member, project, client, tag, task, start, end, active, billable, type. |
| 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. |
| solidtime_time_entry_updateB | Update a time entry. PUT .../time-entries/{timeEntry}. Set end to stop a running timer. Omit confirm for a dry-run. |
| solidtime_time_entry_deleteA | Delete a time entry. DELETE .../time-entries/{timeEntry}. Irreversible. Omit confirm for a dry-run. |
| solidtime_time_entries_bulk_updateB | Update many time entries. PATCH .../time-entries. Irreversible for the listed ids. Omit confirm for a dry-run. |
| solidtime_time_entries_bulk_deleteA | Delete many time entries. DELETE .../time-entries?ids[]. Irreversible. Omit confirm for a dry-run. |
| solidtime_time_entries_exportC | Export time entries. GET .../time-entries/export. format csv, pdf, xlsx, or ods. start and end required by the API. |
| solidtime_time_entries_aggregateC | Aggregate time entries. GET .../time-entries/aggregate. Optional group and sub_group. |
| solidtime_time_entries_aggregate_exportC | Export aggregated time entries. GET .../time-entries/aggregate/export. format, group, sub_group, history_group, start, and end required. |
| solidtime_timer_activeA | Get the active timer of the authenticated user. GET /api/v1/users/me/time-entries/active. |
| solidtime_timer_startB | Start a timer by creating a time entry with end=null. POST .../time-entries. Omit confirm for a dry-run. |
| solidtime_timer_stopA | Stop a running timer by setting end. PUT .../time-entries/{timeEntry}. Defaults to the active entry. Omit confirm for a dry-run. |
| solidtime_reportsC | Saved reports. action list, get, create, update, delete. Public share uses is_public. Writes need confirm. |
| solidtime_public_reportA | 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. |
| solidtime_chartsC | 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. |
| solidtime_importersC | List available importers. GET .../importers. |
| solidtime_importA | Import data into the organization. POST .../import. Omit confirm for a dry-run. |
| solidtime_export_organizationA | Export organization data. POST .../export. Omit confirm for a dry-run. |
| solidtime_invoice_settingsB | Invoice settings. action get or update. Professional feature. Missing plans return a clean not-available error. Writes need confirm. |
| solidtime_invoice_recipientsC | Invoice recipients. action list, get, create, update, delete, duplicate. Professional feature. Writes need confirm. |
| solidtime_invoicesC | Invoices. action list, get, create, update, delete, copy, download, download_e_invoice. Professional feature. Writes need confirm. |
| solidtime_cancel_trialA | Cancel the organization trial. POST .../trial/cancel. Omit confirm for a dry-run. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
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.