Skip to main content
Glama
dustinestes

Clockify MCP Server

by dustinestes
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

Unofficial agent plugin for Clockify: MCP tools plus Agent Skills — start/stop timers, enter time, and summarize sessions in Cursor and other MCP hosts.

Not affiliated with, endorsed by, or sponsored by Clockify or Cake.com. Third-party connector only.

Features

Feature

Description

Documentation

Easy Installation

Single user-scoped MCP server utilizing a single Clockify API key

Config

Granular Repo Integration

Initialize and configure on a per-repo basis

Config

Easy Uninstallation

Skills and scripts rollback changes with guards to prevent overreach or harm

Use

Good Hygiene

Plugin artifacts are gitignored by default

Config: git hygiene

Three Time Entry Methods

Running timer, explicit start/stop times, automated using workflow triggers

schema

IDE Layouts

Supports: single-window, multi-window, multi-root code workspace

Config: which repo

Customize Time Entry

Configure nearest/up/down rounding, start/stop, increment, minimums, include seconds

schema: rounding

Overlap guards

Handle overlapping time entries based on config

schema: overlap

Config shapes

Repo as project (default) or repo as task — how git lines up with Clockify

Config: shape

Description templates

Use tokenized string with github properties or have the agent prompt you

schema

Timer Runaway Prevention

Stop a timer after inactivity to prevent timer runaway

schema: inactivity

Related MCP server: timely-mcp-server

How it works

Two modes. Both use the same Clockify project for a given repo config. Clockify still allows only one running timer. How that project maps to git (repo as project vs repo as task): Config: shape.

Mode

How time gets in

Skills

Manual

You (or the agent, when you ask) start/stop a timer or log a completed range

/clockify-start-timer, clockify-stop-timer, /clockify-enter-time

Automated

Agent follows Cursor rules/hooks from automated.triggers (issue/PR events in session)

/clockify-automate on; /clockify-unautomate revert to manual

Getting started

Prerequisites

Need

Why

Node 18+ (npm / npx)

Install script and the MCP npx command

Cursor (or AI Agent/IDE)

Run skills and MCP

Clockify API key

MCP sevrver connection to Clockify

If Cursor cannot find node / npx, see troubleshoot.

Additional Prerequisites

Install the plugin (once per machine)

  1. Create a Clockify API key (Preferences → Advanced → Manage API Keys).

  2. Run npx -y -p @dustinestes/clockify-agent-plugin clockify-install-cursor — installs skills + global MCP (docs/install-cursor.md). Optional: Directory MCP button (MCP only; caveats).

  3. Reload Cursor; confirm Customize → MCP shows clockify-agent-plugin enabled.

  4. Optional: pre-allow Clockify MCP tools so agents do not stall on an Allow / Always allow prompt mid-run.

Credentials, allowlists, and non-Cursor hosts: docs/use.md.

Add Clockify to a repo (each repo)

  1. In that repo, run /clockify-init — choose Clockify workspace, write config, ignore, Clockify project, optional GitHub label→task sync. After this you can enter time with skills (start/stop timer, enter-time, summarize).

  2. Optional: run /clockify-automate so the agent starts/stops timers from automated.triggers (issues/PRs).

To undo a repo without uninstalling the plugin: docs/use.md.

Skills

You talk to the agent in plain language (or run a /skill). The agent calls MCP tools; you do not.

Setup skills (init, uninit, automate, unautomate) are slash-only so they do not fire by accident.

Group

Skill

Purpose

Example

Repo

clockify-init

Setup the current working directory (config + ignore + project + GitHub label→task sync)

/clockify-init

Repo

clockify-uninit

Full local teardown (keep plugin unless asked)

/clockify-uninit

Mode

clockify-automate

Agent mode on: Cursor rules/hooks from automated.triggers

/clockify-automate

Mode

clockify-unautomate

Agent mode off: remove rule/hooks; keep .clockify/

/clockify-unautomate

Timer

clockify-start-timer

Start a running timer (entry_method: timer)

/clockify-start-timer or “start a timer on this issue”

Timer

clockify-stop-timer

Stop the running timer

/clockify-stop-timer or “stop my Clockify timer”

Timer

clockify-status

Read-only running timer (or none)

/clockify-status or “is a timer running?”

Time

clockify-enter-time

Completed range, no rounding (entry_method: manual)

/clockify-enter-time or “log 2–3pm on this issue”

Review

clockify-summarize

Today / range totals

/clockify-summarize or “how much time today?”

Developing

Working on this repo: docs/develop.md. Shipping a release or Directory listing: docs/publish.md. How to contribute: CONTRIBUTING.md.

Clockify Agent Plugin

MIT License

Install Server
A
license - permissive license
A
quality
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
1dResponse time
–Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • hithereiamaliff-mcp-nextcloud

    A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

  • PlanExe

    MCP server for generating rough-draft project plans from natural-language prompts.

  • Supabase

    MCP server for interacting with the Supabase platform

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/dustinestes/clockify-agent-plugin'

If you have feedback or need assistance with the MCP directory API, please join our Discord server