How to Use the ClickTime MCP in Claude Code

Q: What's the best way to get a CSV from ClickTime data using Claude Code?

Use the jq utility. Run your Claude Code command, pipe the JSON output to jq, and use its filters to format the data into CSV. For example: claude mcp run listclicktimeusers jq -r '. .UserID, .Name @csv'.

Pipe ClickTime data into your shell scripts and CI/CD jobs with Claude Code. No browser, no IDE, just pure command-line access.

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 Claude Code

Create your Vinkius account to connect ClickTime to Claude Code 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 Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Reports in Your CI Pipeline

This tool lets you run ClickTime operations from any shell, which is perfect for automation. Add a step to your GitHub Actions workflow to perform a weekly time audit. A single `claude mcp run get_high_volume_time_report` command pulls the data. You can then pipe the output to `jq` for filtering or to another script that checks for compliance and sends alerts. It makes scheduled reporting trivial.

ClickTime Data Right in Your Terminal

Forget logging into the web UI just to find an ID or check a project name. This MCP Server puts your ClickTime data at your fingertips in the command line. You can run commands like `claude mcp run list_clicktime_projects` and pipe the output to `grep` or `fzf` to instantly find what you need. It's faster and fits right into your existing terminal workflow.

Build Cron Jobs for Monitoring

Use Claude Code to build simple, powerful monitoring scripts. You can set up a cron job that runs every night to check project budgets. The script can call `list_clicktime_jobs` and `list_time_entries` to sum up hours against a specific job. If the total exceeds a threshold, the script can send a cURL request to a Slack webhook. No complex backend service required.

Setup guide

Set up ClickTime MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see clicktime-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest ClickTime transactions." It will automatically discover and invoke the available ClickTime tools.

Terminal

claude mcp add --transport http clicktime-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
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

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "clicktime-mcp": {
      "type": "url",
      "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 Claude Code

First, you add the managed MCP server from Vinkius using the `claude mcp add` command with your unique endpoint URL. After that, Claude Code can access all the ClickTime tools automatically.

Yes, absolutely. Since Claude Code is a command-line tool, it works perfectly inside Docker. You can build a container with it installed to run reports or checks as part of a larger automated system.

Use the `jq` utility. Run your Claude Code command, pipe the JSON output to `jq`, and use its filters to format the data into CSV. For example: `claude mcp run list_clicktime_users | jq -r '.[] | [.UserID, .Name] | @csv'`.

No. The connection is stateless. Claude Code makes a request to the server endpoint for each command you run, gets the data, and then the connection closes. It doesn't maintain a persistent session.

Claude Code can request your lists of users, projects, clients, and time entries. The Vinkius platform secures every request with your personal token, and each tool execution happens in a sandboxed environment that's torn down immediately after.

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