How to Use the DeskTime MCP in Cursor

Q: Can Cursor pull live DeskTime employee performance stats?

The editor uses the getemployeeperformance tool to read those exact numbers. You get actual efficiency scores injected into your workspace instead of writing blind API calls.

Q: Does the DeskTime MCP Server allow Cursor to create new tasks?

It triggers the createnewtask tool based on your instructions. You highlight a block of technical debt, and the agent pushes a new work item to the tracking system.

Bring DeskTime tracking data into Cursor to build internal tools and manage project tasks without leaving your code editor.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect DeskTime MCP to Cursor

Create your Vinkius account to connect DeskTime 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 DeskTime with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build dashboards with Cursor and DeskTime

The `get_company_info` and `list_employees` tools feed real organizational structures straight into your editor while you write internal admin panels. Cursor reads the actual JSON response from the API, formatting your frontend components to match the exact data types coming back. Writing mock data wastes time when you need to test table layouts. Agent mode hits the endpoint, grabs live staff records, and injects that payload into your test files or React state initializers.

Sync code repositories to tracking projects

Connecting your codebase to time tracking requires `list_projects` and `get_project_details` to map repository folders to billing codes. You ask the agent to find the matching project ID for the current repo, and it searches the database. Setting up new initiatives happens through `create_project` right from the terminal prompt. A developer starts a new microservice, tells the editor to create a matching bucket, and the MCP Server handles the rest.

Manage tasks through this MCP Server

Your AI client calls `list_project_tasks` to show you what needs building before you even open a file. The agent fetches the active requirements and drops them into your context window as a checklist. Finishing a feature means you trigger `mark_task_completed` alongside your git commit. You write the code, tell the agent to close the related issue, and it updates the external system automatically.

Setup guide

Set up DeskTime 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 DeskTime 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 DeskTime transactions." If the MCP tools are loaded correctly, Cursor will call the DeskTime tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "desktime-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 DeskTime. 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 DeskTime 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 DeskTime MCP in Cursor

Create an mcp.json file in your project root or global settings directory. Paste the server command or remote URL into the mcpServers array. Toggle Agent mode on in your chat panel to activate the tools.

The editor uses the get_employee_performance tool to read those exact numbers. You get actual efficiency scores injected into your workspace instead of writing blind API calls.

Context switching breaks focus. Developers building internal tools or managing their own sprint tasks can read list_online_staff or complete items without switching browser tabs.

It triggers the create_new_task tool based on your instructions. You highlight a block of technical debt, and the agent pushes a new work item to the tracking system.

Vinkius routes your API requests through isolated, single-use sandboxes. Task descriptions, company performance reports, and employee lists never touch persistent storage. The connection drops completely once the prompt resolves.

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