Skip to content
English
  • There are no suggestions because the search field is empty.

AI Desktop Apps: Connect Gemini to Time Doctor

Note: Available only to beta customers for now. 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

See Connect Command-Line AI Tools to Time Doctor.

The Gemini app 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 Company Settings → AI Connections.
  • Have the Time Doctor server details ready:
  • Server URL: https://api2.timedoctor.com/api/2.0/mcp/mcp
  • Transport: Streamable HTTP

 

Gemini Enterprise

Set up Gemini Enterprise centrally. This section is intended for a Google Cloud administrator rather than everyday users. Expect the setup to take longer than a typical app connection, since it involves organization policy and network settings in addition to the connection itself.

What the Administrator Needs First

    • The Discovery Engine Editor role in the Google Cloud project.
    • Permission to change organization policy, since custom MCP servers are blocked by default and the block must be lifted.
    • Permission to change allowed egress domains, so that api2.timedoctor.com can be reached.

Setting Up the Connection

    • In the Google Cloud console, open Gemini Enterprise, then Data Stores, then Create Data Store.
    • Search for Custom MCP Server and select Add MCP Server.
    • Enter the Time Doctor server URL. Gemini Enterprise supports streamable HTTP only, which is what Time Doctor uses.
    • Name the connector (for example, Time Doctor) and choose a location.
    • For authentication, select OAuth 2.0. Contact support@timedoctor.com for any required Time Doctor values.
    • Save the data store. Gemini Enterprise connects to Time Doctor and lists the available actions.
    • Switch on the actions to use. No actions are enabled by default. Select the Time Doctor actions the team needs, then select Enable Actions. Up to 100 actions can be enabled at once.

Once the actions are enabled, users can ask Gemini about Time Doctor data in plain language. Every request still respects each person's own Time Doctor role, so no one sees more than they would see in Time Doctor itself.

Google's own guide: Set Up a Custom MCP Server Data Store.

 

Antigravity

Antigravity is Google's agentic development environment. Connect Time Doctor directly, with no administrator involved.

  1. 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.
  2. 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"
        }
      }
    }
  3. Antigravity opens the Time Doctor sign-in in the browser. Sign in and select Allow Access. No client ID or secret is needed.
  4. 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 Settings → AI Connections, 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 Settings → AI Connections. 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 Company Settings → AI Connections, 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.

Gemini Enterprise: have the administrator remove the Time Doctor data store, or disable its actions.

Access can also be ended from the Time Doctor side, in Settings → AI Connections, 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.