AI Desktop Apps: Connect Gemini to Time Doctor
Note: The Time Doctor MCP is available on all Time Doctor subscription plans and can be accessed by Owners, Admins, and Managers.
TL;DR:
Connect Gemini Enterprise, Antigravity, or Gemini CLI to the Time Doctor MCP to ask questions about Time Doctor data in plain language. Gemini Enterprise requires a Google Cloud administrator to configure a custom MCP data store; Antigravity can be connected directly by an individual user in a couple of minutes; Gemini CLI follows the same setup as other command-line AI tools. The Gemini app at gemini.google.com does not support this connection.
Find the Right Setup Path
|
Google AI Tool |
How to Connect |
|---|---|
|
Gemini Enterprise, provided by an organization |
An administrator sets it up in the Google Cloud console. See the Gemini Enterprise section below. |
|
Antigravity, Google's agentic development environment |
Set it up directly in a couple of minutes. See the Antigravity section below. |
|
Gemini CLI, in the terminal |
|
|
The Gemini app via Google Workspace at gemini.google.com |
Not supported. The Gemini app cannot connect to custom MCP servers. Use Antigravity or Gemini CLI instead. |
Before Starting
- Use a Time Doctor login with the Owner, Admin, or Manager role.
- Confirm that an Owner or Admin has enabled Time Doctor MCP in the Company Settings page.
- Have the Time Doctor server details ready:
- Server URL: https://api2.timedoctor.com/api/2.0/mcp/mcp
- Transport: Streamable HTTP
Gemini Enterprise
Time Doctor MCP is not available in Gemini Enterprise yet. We are working on it.
What to use meanwhile. Both of these work today, both are free, and both connect with a Time Doctor sign-in rather than keys:
- Antigravity, Google's agentic development environment. See the Antigravity section below
- Gemini CLI, in your terminal. See Connect Command-Line AI Tools to Time Doctor
Antigravity
Antigravity is Google's agentic development environment. Connect Time Doctor directly, with no administrator involved.
- Open Settings, then Customizations, then Installed MCP Servers, and select Add MCP. Alternatively, open the agent side panel, select the ... menu, choose MCP Servers, then Manage MCP Servers, then View Raw Config.
- Add Time Doctor to the config, then save. Antigravity requires the field to be called serverUrl. It does not accept url or httpUrl.
{"mcpServers": {"timedoctor": {"serverUrl": "https://api2.timedoctor.com/api/2.0/mcp/mcp"}}} - Antigravity opens the Time Doctor sign-in in the browser. Sign in and select Allow Access. No client ID or secret is needed.
- Ask about Time Doctor data in the agent panel.
Config file locations: ~/.gemini/config/mcp_config.json for all work, or .agents/mcp_config.json inside a project folder for that project only.
To manage the connection later, return to Installed MCP Servers, where the connection can be switched off, refreshed, or removed with the bin icon.
Google's own guide: MCP in Antigravity.
Gemini CLI
For terminal use, Gemini CLI connects to Time Doctor with the same sign-in. See Connect Command-Line AI Tools to Time Doctor for the steps, alongside Claude Code and Codex CLI.
Try the First Question
Once connected, paste this prompt:
"Help me get started with my Time Doctor data. Ask me about my goals and build my first report."
Advanced: Connect With an API Key
In Antigravity, use an API key instead of signing in, which suits an agent that runs unattended. Create a key in Time Doctor under the AI Connections page, then add a headers block:
"timedoctor": { "serverUrl": "https://api2.timedoctor.com/api/2.0/mcp/mcp", "headers": { "x-api-key": "YOUR_API_KEY" }}
Treat the key like a password: keep it private, do not share it, and revoke it anytime from the AI Connections page. For a full walkthrough, see Connect Autonomous AI Agents to Time Doctor.
Troubleshooting
|
Problem |
Fix |
|---|---|
|
Antigravity rejects the config |
Check the field name. Antigravity needs serverUrl, and does not accept url or httpUrl. |
|
Antigravity does not pick up the change |
Save the file, then refresh the server from Installed MCP Servers, or restart Antigravity. |
|
The browser sign-in page does not open |
Check that the browser did not block the pop-up, then connect again. |
|
Sign-in fails, or a permissions error appears |
Confirm with the Time Doctor Owner or Admin that Time Doctor MCP is enabled in the Company Settings page, and that the assigned role is Owner, Admin, or Manager. |
|
Gemini Enterprise cannot reach the server |
Ask the Google Cloud administrator to confirm that api2.timedoctor.com is on the allowed egress domains list, and that the organization policy blocking custom MCP servers has been lifted. |
|
Gemini Enterprise connects but no Time Doctor tools are available |
No actions are enabled by default. Ask the administrator to select the Time Doctor actions and select Enable Actions. |
|
Time Doctor does not appear in the Gemini app |
The Gemini app at gemini.google.com does not support custom MCP servers. Use Antigravity or Gemini CLI instead. |
Disconnecting
Antigravity: remove Time Doctor from Installed MCP Servers, or delete its entry from the config file.
Access can also be ended from the Time Doctor side, in the AI Connections page, which immediately stops that tool from reading data.
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.