Connect a Custom AI Tool to Time Doctor - Beta
Note: The AI connection (MCP) is available on all Time Doctor subscription plans and can be accessed by Owners, Admins, and Managers.
TL;DR:
Create a connection key in Time Doctor's Settings / AI Connections, then point any MCP-capable tool at the Time Doctor server URL with that key as an x-api-key header. This works with tools such as Windsurf, Zed, Cline, and Replit — use this guide when the tool is not covered by its own dedicated article.
Before Starting
- In Time Doctor, go to Settings / AI Connections, click Connect an AI Tool, select Custom Tool, and click Create Connection. Copy the connection key. It is shown only once, so store it somewhere safe.
Set Up the Connection
- In the tool's MCP settings, add a server with this URL: https://api2.timedoctor.com/api/2.0/mcp/mcp
- Add a header named x-api-key with the connection key as the value.
- If offered a connection type, choose Streamable HTTP.
Does the tool use a JSON config file instead? Add Time Doctor with the option that matches the file. The mcpServers format below is the most common, but check the tool's own MCP docs first — some tools use a different top-level key or field name. For example, Windsurf uses serverUrl instead of url, and Zed uses context_servers instead of mcpServers.
Empty or new config file? Copy the full file:json{"mcpServers": {"timedoctor": {"url": "https://api2.timedoctor.com/api/2.0/mcp/mcp","headers": {"x-api-key": "YOUR_API_KEY"}}}}
File already has other servers? Copy only the Time Doctor entry and paste it inside the existing section:json"timedoctor": {"url": "https://api2.timedoctor.com/api/2.0/mcp/mcp","headers": {"x-api-key": "YOUR_API_KEY"}} - Save, then ask about Time Doctor data in the tool.
Next Step
See Getting Started: What to Ask Your Time Doctor AI Connection.
Should there be any inconsistencies or concerns regarding the article, contact support@timedoctor.com for prompt assistance.