How to Use the Clockify MCP in Cursor

Q: Does Cursor support starting and stopping Clockify timers?

Yes. You can ask the agent to hit stopcurrenttimer if you left a task running, or log new blocks manually.

Inject live Clockify workspace data and time entries straight into your code using Cursor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Clockify MCP to Cursor

Create your Vinkius account to connect Clockify to Cursor and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Clockify with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Hardcode real workspace IDs with Cursor

Writing API scripts usually means hunting through documentation to find your account IDs. Cursor just runs `get_my_clockify_profile` to grab your exact authentication details while you type. When you need the actual environment IDs, the agent fires `list_clockify_workspaces`. It drops the real string directly into your constants file so you can keep building.

Generate billing scripts from live project data

Mock data wastes time when you build internal invoicing tools. Your AI client pulls the actual customer roster using `list_workspace_clients` and writes the exact parsing logic you need. Then it hits `list_workspace_projects` to map those clients to active jobs. Cursor builds your data models based on the exact JSON schema returning from your live account.

Test time tracking logic via MCP Server

Building custom dashboards requires testing actual time payloads. You can tell Cursor to log a test block using `add_new_time_entry` to see how your UI handles the new record. To verify the fetch logic, the agent runs `list_user_time_entries`. You see exactly how the timestamps format before you write a single line of frontend code.

Setup guide

Set up Clockify MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Clockify MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Clockify transactions." If the MCP tools are loaded correctly, Cursor will call the Clockify tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "clockify-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Clockify. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Clockify now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Clockify MCP in Cursor

Create an mcp.json file in your project root. Paste the server command or Vinkius remote URL, then turn on Agent mode in the chat.

No. The current tools let you read existing projects and log time, but you cannot generate new project containers from the editor.

Context. When you build internal tools, you need live API responses to write accurate data models. This pulls the real JSON directly into your editor.

Yes. You can ask the agent to hit `stop_current_timer` if you left a task running, or log new blocks manually.

Vinkius handles the authentication layer entirely. Your project lists and user time entries route through a zero-trust gateway. Cursor never stores your raw API credentials locally.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript