eHour MCP Server

The eHour MCP Server lets AI tools work directly with your eHour data. Instead of clicking through reports or updating data manually, you can just ask.

You can use tools like Claude Code, Copilot, or Codex (OpenAI) to log time, manage projects and users, and run reports, all through natural language.


What you can do

The MCP server is capable of:

  • Logging and updating time entries (manual or via timers)
  • Managing clients, projects, tasks, and assignments
  • Inviting, updating, or archiving users and manage teams
  • Running reports and asking questions about your data

Examples

Here are a few things you can ask:

I logged all my time last week to 'Acme Onboarding' by mistake. Move those entries over to 'Acme Phase 1'.
 
Start a timer for the Website Redesign project at Globex.

Who on the Engineering team hasn't submitted their timesheet for last week?

Create client 'Initech', add a 'Phase 1' project under it, and assign the Design team at €95/hr.

Run a monthly billable-hours report for the Mobile App project in Q3.

You can refine results, ask follow-ups, or combine questions, just like you would with any AI tool.

Access & permissions

Access follows your existing eHour roles and permissions. If you can’t do something in eHour, the MCP Server won’t allow it either.

Admins need to enable the MCP Server first in the Admin section and can decide which users or roles have access.

Install

To get started, connect your MCP-compatible client.


Claude Code

From the command line, run:

claude mcp add --transport http ehour https://ehourapp.com/mcp

Claude Desktop

Edit claude_desktop_config.json  :

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json  
  • Windows: %APPDATA%\Claude\claude_desktop_config.json  
{   "mcpServers": {     "ehour": {       "command": "npx",       "args": ["-y", "mcp-remote", "https://ehourapp.com/mcp"]     }   } }

mcp-remote   bridges the HTTP server into Desktop's stdio transport and runs the OAuth flow in your browser. Restart Claude Desktop after editing.


Codex CLI

Edit ~/.codex/config.toml  :

[mcp_servers.ehour]
url = "https://ehourapp.com/mcp"

Then authorize:

codex mcp login ehour

Some more examples

Tracking Time

  • “What did I track this week?”
  • “Log 3 hours on the API refactor yesterday.”
  • “Log 7.5 hours on Acme Website with the comment ‘release prep’.”
  • “Start a timer for Mobile App, task Frontend.”
  • “Stop the timer and record it.”
  • “Is a timer running right now?”

Projects, clients, tasks

  • “Create client Acme with projects Website Redesign and Mobile App.”
  • “Assign Alice, Bob, and Carol to Website Redesign at €95/hr.”
  • “Set a hard budget of 200 hours on the iOS App project.”
  • “Rename project ‘Mobile App’ to ‘iOS and Android App’.”
  • “Remove Bob from the Website Redesign project.”
  • “List every active project for client Acme.”

Users and teams

  • “Invite alice@example.com as a consultant on the Design team.”
  • “Onboard these three people as project managers: alice@…, bob@…, carol@….”
  • “Create team ‘Mobile’ and add Alice, Bob, Carol.”
  • “Move David from the Backend team to the Platform team.”
  • “Set Alice’s contract hours to 32 and her line manager to Bob.”
  • “Archive every contractor who hasn’t logged time this year.”

Reporting

You can run both saved and custom reports.

Try asking your AI:

  • “Show me hours per project for Q1 this year.”
  • “Run a weekly report of billable hours by user for client Acme.”
  • “List my saved reports.”
  • “Open the ‘Monthly utilisation’ report.”

Reports can be filtered by date, project, client, or user, and grouped by day, week, month, and more.

Still need help? Contact Us Contact Us