Connect Time Doctor to Your AI Tools (MCP) - Beta
Note: AI Connection (MCP) are available on all Time Doctor subscription plans. Owners, Admins, and Managers can use them.
TL;DR:
The AI connection (MCP) links an AI assistant, such as Claude or ChatGPT, to Time Doctor data for plain-language reporting. Pick your AI tool below for a step-by-step setup, then see Getting Started: What to Ask to make the most of it. Access is read-only and limited to the assigned user role.
What Are AI Connections?
Connect an AI assistant to Time Doctor using the AI connection (MCP) and ask questions in plain language. Reduces time reviewing reports: ask a question directly, and the AI assistant answers using live Time Doctor data.
AI connection access is read-only. The connection can read and report data but cannot change, add, or delete anything in Time Doctor. Data shown is limited to what the assigned user role is permitted to see. Owners and Admins can ask about everyone in the company; Managers see their assigned teams.
Connection Details (for Any Tool)
The AI connection uses a personal API key (sent as an x-api-key header). Treat the key like a password: keep it private, don't share it, and revoke it anytime from Settings → AI Connections. For security, your key is shown only once, when you create it.
If your AI tool supports a custom MCP connection with header-based authentication, you can connect it manually:
- Server URL: https://api2.timedoctor.com/api/2.0/mcp/mcp
- Auth header: x-api-key: <your key>
- Connection type: Streamable HTTP (read-only)
Config template (works with most tools that use a JSON config file):
{ "mcpServers": { "timedoctor": { "url": "https://api2.timedoctor.com/api/2.0/mcp/mcp", "headers": { "x-api-key": "YOUR_API_KEY" } } }}
The key isn't tied to a specific tool. The same key works with any MCP-capable client.
Set Up Your AI Tool
Setup takes about five minutes. In Time Doctor, go to Settings → AI Connections, click Connect an AI tool, and follow the guide for your tool:
|
AI tool |
Setup guide |
|
Claude Desktop |
|
|
ChatGPT |
|
|
Claude Code, Codex CLI, Gemini CLI |
|
|
Cursor, VS Code |
|
|
Any other MCP-capable tool |
What the AI Connection Can Access
|
Data |
What it includes |
|
Hours & time worked |
Tracked, active, and idle time; computer, manual, mobile, and break time |
|
Apps & websites |
Time per website and app, with productivity rating and category |
|
Productivity |
Productive / unproductive / neutral / unrated time by app, category, or task |
|
Meetings |
Meeting and call time, when they happened, and talk time |
|
Projects & tasks |
Time spent per project and per task, by user |
|
Attendance & schedules |
Scheduled shifts and attendance against schedule (present, absent, late) |
|
Leave & time off |
Leave taken, by type and duration |
|
People, teams & groups |
Users, the people a manager manages, and group/tag membership |
What it does not access: the AI connection can't change any data, and it doesn't expose raw screenshots, payroll, or billing. It returns only the summarized data above.
Next Step
Once connected, see Getting Started: What to Ask Your Time Doctor AI Connection, including a starter prompt that helps the AI build your first report around your goals.
Should there be any inconsistencies or concerns regarding the article, contact support@timedoctor.com for prompt assistance.