How to Use the Everhour Time Tracking MCP in Claude Code

Q: Can I filter Everhour time records by user with Claude Code?

The listteamtimerecords tool doesn't filter by user on the server, but you can do it on the client. Pipe the JSON output to jq and filter the array by the user ID you get from listorganizationteammembers. It's the standard Unix philosophy.

Q: How do I connect the Everhour Time Tracking server to Claude Code?

It's a single command in your terminal: claude mcp add --transport http everhour -- . Once you run that, your configuration is saved and you can start calling tools immediately.

Pipe Everhour data into any script or cron job with Claude Code. Get project budget status or team hours right in your terminal.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Everhour Time Tracking MCP to Claude Code

Create your Vinkius account to connect Everhour Time Tracking 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 Everhour Time Tracking with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run Reports from Your Terminal

This is for anyone who lives in the command line. You can pull any data you need from Everhour without ever touching a web UI. It's fast and scriptable. For example, run `claude mcp call everhour list_team_time_records -- --date-range '2024-01-01/2024-01-31'` and pipe the JSON output directly to `jq` for filtering. You can build custom reports on the fly for any date range.

Add Budget Checks to Your CI/CD

Use this MCP server to put a financial guardrail on your projects. You can add a simple script to your build pipeline that checks project health before deploying. Your script just needs to call `list_projects_within_budget`. If the tool returns any projects that are over budget, you can have your script fail the build and send an alert to your team's chat. It's a simple way to enforce discipline.

Automate Daily Time Audits

Set up a simple cron job to run a `quick_time_tracking_audit` every morning at 9 AM. Claude Code executes the call and gives you the raw output to work with. You can pipe the summary to a script that formats it and sends it to you as an email or a chat message. You get a daily digest of project activity without having to log in to Everhour and run the report yourself.

Setup guide

Set up Everhour Time Tracking 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 everhour-time-tracking-mcp with a green status indicator.
3

Start using tools

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

Terminal

claude mcp add --transport http everhour-time-tracking-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 Everhour Time Tracking 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": {
    "everhour-time-tracking-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 Everhour Time Tracking. 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 Everhour Time Tracking 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 Everhour Time Tracking MCP in Claude Code

In your workflow YAML, install the Claude Code CLI, then add your Everhour MCP server using `claude mcp add`. You can then use `claude mcp call everhour list_projects_within_budget` and use the output or exit code to pass/fail the job.

The `list_team_time_records` tool doesn't filter by user on the server, but you can do it on the client. Pipe the JSON output to `jq` and filter the array by the user ID you get from `list_organization_team_members`. It's the standard Unix philosophy.

It's a single command in your terminal: `claude mcp add --transport http everhour -- `. Once you run that, your configuration is saved and you can start calling tools immediately.

Automation. It's designed for headless environments. Use it for cron jobs that send daily reports, CI/CD pipelines that check budgets, or any shell script where you need live data from Everhour.

Your API token is used to fetch specific Everhour data like time entries and project lists. This data is streamed directly through Vinkius's ephemeral infrastructure to your terminal or script. Nothing is logged or stored on our servers.

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