hours-for-teams-mcp

MCP server for Hours for Teams time tracking. Lets AI assistants fetch time entries, manage timers, and view extra time records.

Tools

| Tool | Description | |------|-------------| | fetch_token | Authenticate and get a session token | | fetch_hours | Fetch time entries for a date range | | fetch_extra_times | Fetch manual/extra time entries for a date range | | list_timers | List all available timers (projects) | | start_timer | Start a timer by GUID | | stop_timer | Stop a timer by GUID |

Setup

Environment Variables

export HOURS_EMAIL="[email protected]"
export HOURS_PASSWORD="your-password"

Claude Code

Add to ~/.claude.json under mcpServers:

"hours-for-teams": {
  "command": "npx",
  "args": ["-y", "hours-for-teams-mcp"],
  "env": {
    "HOURS_EMAIL": "[email protected]",
    "HOURS_PASSWORD": "your-password"
  }
}

Other MCP Clients

npx hours-for-teams-mcp

The server communicates over stdio using the Model Context Protocol.

Date Format

All date parameters are unix timestamps in seconds. For a single day, set end_date to start_date + 86400.