Skip to main content
The Everhour MCP server lets an AI assistant read and write your Everhour data on your behalf — start a timer, log time, check your timesheet, or find a task — without you switching tabs or memorizing IDs. You describe what you want in plain language and the assistant calls the right tool. It implements the Model Context Protocol (MCP), an open standard for connecting AI clients to external tools and data. Any MCP-capable client can connect.

​
Server details

Endpoint

POST https://api.everhour.com/mcp

Transport

Streamable HTTP

Protocol

MCP 2025-06-18, JSON-RPC 2.0

Authentication

OAuth 2.1 (or X-Api-Key for manual setups)

​
What you can do

Once connected, your assistant has access to 24 tools covering everyday time tracking:
  • Track time in real time — start, stop, and check your running timer.
  • Log and edit time — add entries (in seconds), fix a duration, delete a wrong entry, or log time retroactively.
  • Review timesheets — read your weekly timesheet with daily totals and a per-task breakdown.
  • Find work across tools — search tasks, list recently tracked tasks, and resolve a task ID or URL from Asana, Jira, GitHub, Linear, and other integrations to the matching Everhour task.
  • Read projects, clients, and team — list and fetch projects, clients, and team members.
  • Report on the team — pull hours by project or member, project budgets, time off, and weekly capacity over any date range (subject to your role).
See the tools reference for the full list with parameters.

​
Authentication

Clients connect with OAuth 2.1. You add the server URL and approve access in your browser — no app to create and no credentials to copy, because Everhour registers your client automatically. The access token is short-lived and refreshes on its own. See Connect an MCP client. For clients that can’t do OAuth, or for headless automation, you can authenticate with an Everhour API key in an X-Api-Key header instead. The key is long-lived and grants full account access, so prefer OAuth where it’s available.
Whichever method you use, the assistant can only do what your Everhour role allows — the same permissions that govern the REST API.

​
Requirements

  • An active Everhour account.
  • An MCP-capable AI client (see supported clients).
  • To authenticate: either a client that supports OAuth (no setup — it registers itself), or your Everhour API key for the header-based method.

​
Next steps

Connect an MCP client

Set up Claude, ChatGPT, Cursor, and other clients.

Tools reference

Every tool the assistant can call, with parameters.