How to Use the ClickTime MCP in Windsurf

Q: Is there a limit to the data Windsurf can pull from ClickTime?

Yes, for large datasets. The gethighvolumetimereport tool is specifically designed for this, but it has a hard limit of 2500 records per request.

Let Windsurf's Cascade agent run your ClickTime reports for you. Just state your goal and it handles the rest, step-by-step.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect ClickTime MCP to Windsurf

Create your Vinkius account to connect ClickTime to Windsurf 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 ClickTime with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Project and Client Audits

This tool gives Windsurf read-only access to your ClickTime account. You can ask it to generate a complete audit for a specific client, and its Cascade agent gets to work. Cascade will chain together the necessary commands automatically. It can run `list_clicktime_clients` to find the right ID, then `list_clicktime_projects` to see what they're paying for, and finish with `list_time_entries` to pull all the hours. You get a full report without prompting each step.

Get a Full Picture of Your Team

Find out who's working on what without digging through the ClickTime web app. Just ask Windsurf to give you a summary of a team member's current workload. It can combine data from `list_clicktime_users` and `list_clicktime_jobs` to map people to their assigned projects. This is great for resource planning or just getting a quick status update before a meeting. Cascade handles the lookups for you.

Your ClickTime MCP Server in Windsurf

Connecting this MCP Server to Windsurf pipes your time tracking data directly into the IDE. You don't need to manage API keys or write any integration code. It just works. Once connected, you can pull massive reports using `get_high_volume_time_report`, which grabs up to 2500 time entries at once. Cascade can then use that data to perform analysis or answer complex questions about your team's logged hours.

Setup guide

Set up ClickTime MCP in Windsurf

Prerequisites

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

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the ClickTime MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my ClickTime payment history." If connected, Cascade will call the ClickTime tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "clicktime-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 ClickTime. 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 ClickTime 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 ClickTime MCP in Windsurf

Windsurf uses the provided tools to read information from your ClickTime account. Its Cascade agent can chain commands, like finding all projects for a client and then listing their time entries, to answer complex questions in one go.

No. The tools provided by this MCP server are for reading data only. You can list clients, projects, jobs, and time entries, but you can't create or modify anything in your ClickTime account.

Just ask for it. For example: "Get me a summary of all time entries for the 'Q3 Launch' project." Windsurf's Cascade will figure out the steps, using `list_clicktime_projects` to get the ID and `list_time_entries` to fetch the data.

Yes, for large datasets. The `get_high_volume_time_report` tool is specifically designed for this, but it has a hard limit of 2500 records per request.

The server only accesses what's necessary to run the tools, like your company's project lists, user profiles, and time tracking entries. All connections are managed by Vinkius inside an ephemeral, zero-trust sandbox for each request.

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