Skip to main content
Glama

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:http

npm 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-mcp

Do not put the API token in the image.

Related MCP server: solidtime-mcp-server

Tools

Tool

Call

solidtime_me

GET /api/v1/users/me

solidtime_memberships

GET /api/v1/users/me/memberships

solidtime_user_update

PUT /api/v1/users/{user}

solidtime_user_set_organization

PUT /api/v1/users/me/current-organization

solidtime_user_delete

DELETE /api/v1/users/{user}

solidtime_user_email

resend verification or reset pending email

solidtime_api_tokens

list, create, revoke, delete

solidtime_countries

GET /api/v1/countries

solidtime_currencies

GET /api/v1/currencies

solidtime_time_zones

GET /api/v1/time-zones

solidtime_organization_get

GET .../organizations/{organization}

solidtime_organization_create

POST /api/v1/organizations

solidtime_organization_update

PUT .../organizations/{organization}

solidtime_organization_delete

DELETE .../organizations/{organization}

solidtime_members_list

GET .../members

solidtime_member_update

PUT .../members/{member}

solidtime_member_remove

DELETE .../members/{member}

solidtime_member_invite_placeholder

POST .../invite-placeholder

solidtime_member_make_placeholder

POST .../make-placeholder

solidtime_member_merge

POST .../member/{member}/merge-into

solidtime_invitations

list, invite, resend, remove

solidtime_projects_list

GET .../projects

solidtime_project_get

GET .../projects/{project}

solidtime_project_create

POST .../projects

solidtime_project_update

PUT .../projects/{project}

solidtime_project_delete

DELETE .../projects/{project}

solidtime_project_members

list, create, update, delete

solidtime_clients

list, create, update, delete

solidtime_tags

list, create, update, delete

solidtime_tasks

list, create, update, delete

solidtime_goals

list, get, create, update, delete

solidtime_time_entries_list

GET .../time-entries

solidtime_time_entry_create

POST .../time-entries

solidtime_time_entry_update

PUT .../time-entries/{timeEntry}

solidtime_time_entry_delete

DELETE .../time-entries/{timeEntry}

solidtime_time_entries_bulk_update

PATCH .../time-entries

solidtime_time_entries_bulk_delete

DELETE .../time-entries?ids[]

solidtime_time_entries_export

GET .../time-entries/export

solidtime_time_entries_aggregate

GET .../time-entries/aggregate

solidtime_time_entries_aggregate_export

GET .../time-entries/aggregate/export

solidtime_timer_active

GET /api/v1/users/me/time-entries/active

solidtime_timer_start

create a time entry with end=null

solidtime_timer_stop

set end on the active entry

solidtime_reports

list, get, create, update, delete

solidtime_public_report

GET /api/v1/public/reports with X-Api-Key set to the share secret

solidtime_charts

dashboard chart endpoints

solidtime_importers

GET .../importers

solidtime_import

POST .../import

solidtime_export_organization

POST .../export

solidtime_invoice_settings

get or update. Professional

solidtime_invoice_recipients

list, get, create, update, delete, duplicate. Professional

solidtime_invoices

list, get, create, update, delete, copy, download. Professional

solidtime_cancel_trial

POST .../trial/cancel

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

SOLIDTIME_URL

https://app.solidtime.io

Instance origin. No userinfo, query, or hash. A trailing /api is stripped

SOLIDTIME_API_TOKEN

unset

Required for an upstream call. At least 8 characters. Never printed

SOLIDTIME_ORGANIZATION_ID

unset

Optional org UUID. Auto-detected when the user has exactly one membership

SOLIDTIME_ALLOW_WRITES

off

The literal true enables writes. Any other value keeps writes as a blocked preview

SOLIDTIME_CONTACT

contact@example.com

Contact inside the User-Agent. Must not contain the token

SOLIDTIME_PER_MINUTE

200

Local sliding-window cap

SOLIDTIME_CACHE_TTL_SEC

60

TTL for successful reads. 0 disables the cache

SOLIDTIME_TIMEOUT_MS

20000

Upstream timeout

MCP_TRANSPORT

stdio

stdio or http. --http forces HTTP

PORT

3000

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 tools
solidtime_api_tokensA
DestructiveIdempotent

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_chartsC
Read-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_clientsC
DestructiveIdempotent

Clients. action list, create, update, delete. Writes need confirm.

Inputs: action (required), name, page, confirm, +4 more.

solidtime_countriesB
Read-only

List countries. GET /api/v1/countries. From the app client routes.

Inputs: no named parameters.

solidtime_currenciesB
Read-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_goalsC
DestructiveIdempotent

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_importersC
Read-only

List available importers. GET .../importers.

Inputs: organization_id.

solidtime_invitationsB
DestructiveIdempotent

Organization invitations. action list, invite, resend, remove. Writes need confirm.

Inputs: action (required), role, email, confirm, +2 more.

solidtime_invoice_recipientsC
DestructiveIdempotent

Invoice recipients. action list, get, create, update, delete, duplicate. Professional feature. Writes need confirm.

Inputs: action (required), name, email, phone, +11 more.

solidtime_invoicesC
DestructiveIdempotent

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_settingsB
Idempotent

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_meA
Read-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_mergeA
DestructiveIdempotent

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_removeA
DestructiveIdempotent

Remove a member. DELETE .../members/{member}. Irreversible. Omit confirm for a dry-run.

Inputs: member_id (required), confirm, organization_id.

solidtime_membershipsA
Read-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_listC
Read-only

List organization members. GET /api/v1/organizations/{organization}/members.

Inputs: organization_id.

solidtime_member_updateA
Idempotent

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_deleteA
DestructiveIdempotent

Delete an organization. DELETE /api/v1/organizations/{organization}. Irreversible. Omit confirm for a dry-run.

Inputs: confirm, password, organization_id.

solidtime_organization_getB
Read-only

Get an organization. GET /api/v1/organizations/{organization}. organization_id is optional when SOLIDTIME_ORGANIZATION_ID is set.

Inputs: organization_id.

solidtime_organization_updateA
Idempotent

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_deleteA
DestructiveIdempotent

Delete a project. DELETE .../projects/{project}. Irreversible. Omit confirm for a dry-run.

Inputs: project_id (required), confirm, organization_id.

solidtime_project_getC
Read-only

Get one project. GET .../projects/{project}.

Inputs: project_id (required), organization_id.

solidtime_project_membersC
DestructiveIdempotent

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_listB
Read-only

List projects visible to the current user. GET .../projects. Optional page and archived.

Inputs: page, archived, organization_id.

solidtime_project_updateA
Idempotent

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_reportA
Read-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_reportsC
DestructiveIdempotent

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_tagsC
DestructiveIdempotent

Tags. action list, create, update, delete. Writes need confirm.

Inputs: action (required), name, tag_id, confirm, +1 more.

solidtime_tasksC
DestructiveIdempotent

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_aggregateC
Read-only

Aggregate time entries. GET .../time-entries/aggregate. Optional group and sub_group.

Inputs: end, type, group, start, +14 more.

solidtime_time_entries_aggregate_exportC
Read-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_deleteA
DestructiveIdempotent

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_updateB
Idempotent

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_exportC
Read-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_listB
Read-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_deleteA
DestructiveIdempotent

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_updateB
Idempotent

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_activeA
Read-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_stopA
Idempotent

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_zonesB
Read-only

List time zones. GET /api/v1/time-zones.

Inputs: no named parameters.

solidtime_user_deleteA
DestructiveIdempotent

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_organizationA
Idempotent

Set the current organization. PUT /api/v1/users/me/current-organization. Omit confirm for a dry-run.

Inputs: confirm, organization_id.

solidtime_user_updateB
Idempotent

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

    C2.9/5.0

    Scored across 53 tools

    Disambiguation3/5

    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.

    Naming Consistency3/5

    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.

    Tool Count2/5

    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.

    Completeness5/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Official 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.
      12
      116 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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