Google Home Developer MCP Server

The Google Home Developer Model Context Protocol (MCP) server gives AI-powered development tools the ability to search the following and retrieve real-time, domain-specific information:

It helps ensure that AI agents and tools can provide accurate technical answers related to Google Home developer programs and technology.

An MCP server acts as a proxy between an external service that provides context or data and an AI application (the host). The Home Developer MCP server exposes executable tools that let Large Language Models (LLMs) find precise answers directly from indexed corpuses. To learn more about MCP servers, see What is the MCP and how does it work?.

Prerequisites

To use the Home Developer MCP server, you must have an MCP-compatible AI client or editor installed.

Google Antigravity

If you are using Google's AI development environment, install one of the following:

Third-Party AI assistants

You can also integrate the MCP with other AI applications, command line tools, and code editors, such as:

  • Claude Code
  • Cursor
  • GitHub Copilot (VS Code)

Choose an authentication path

Depending on your integration requirements, you can connect to the Home Developer MCP server using either an unauthenticated trial path or an authenticated API key.

Unauthenticated connection testing

This method does not require any API key or Google Cloud configuration. It uses a shared public quota, making it the easiest way to trial the server and test core mechanics immediately.

Authenticated connection for production

To prevent rate-limiting under shared public quotas, authenticating your environment is recommended for sustained development.

This path requires you to have an active Google Cloud project.

  1. In the Google Cloud console, enable the API on your project:
    1. Open the Home Developers API page in the Google APIs library.
    2. Check that you have the correct project selected in which you intend to use the API.
    3. Click Enable.
  2. Create an API Key:

    1. Go to the Credentials page.
    2. Click Create credentials, and then select API key from the menu.
    3. In the Name field, provide a name for the key.
    4. Click the Select API restrictions drop-down, and then type Home Developers API. Click the result, and then click OK.

    5. Click Create.

    6. After the key is created, click Show key to view it, and copy it for the next step.

Configure your client

There are several development environments that can connect to the Home Developer MCP server using either an unauthenticated or authentication configuration. See each environment instructions to set up the server.

Enter your API key: YOUR_API_KEY

Antigravity

Open your local ~/.gemini/config/mcp_config.json configuration file and add the HomeDevelopers entry under the mcpServers object.

Regardless of whether you use the Antigravity CLI, Antigravity 2.0, or Antigravity IDE, all of these tools share the same configuration file located at ~/.gemini/config/mcp_config.json. Any changes or server mappings you define in this file automatically apply across all three environments.

Unauthenticated

{
  "mcpServers": {
    "HomeDevelopers": {
      "serverUrl": "https://homedevelopers.googleapis.com/mcp"
    }
  }
}

Authenticated

{
 "mcpServers": {
    "HomeDevelopers": {
      "serverUrl": "https://homedevelopers.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Claude

To configure Claude Code, run the command under your application directory.

Unauthenticated

claude mcp add HomeDevelopers --transport http https://homedevelopers.googleapis.com/mcp

Authenticated

claude mcp add HomeDevelopers --transport http https://homedevelopers.googleapis.com/mcp --header "X-Goog-Api-Key: "YOUR_API_KEY"

Cursor

To configure Cursor, edit either .cursor/mcp.json (for a specific project) or ~/.cursor/mcp.json (for all projects).

Unauthenticated

{
  "mcpServers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp"
    }
  }
}

Authenticated

{
  "mcpServers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

GitHub Copilot

To configure GitHub Copilot in VS Code for a single project, edit the .vscode/mcp.json file in your workspace. Alternatively, to make the server globally available, click the Open Settings (JSON) button in your user settings and add the JSON under a "mcp" root key.

Unauthenticated

{
  "servers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp"
    }
  }
}

Authenticated

{
  "servers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Verify installation and execution

Once your tool configuration is updated, verify the connection by prompting your agent workspace.

Verification example (Antigravity CLI)

  1. Launch your interactive workspace session:

    agy
    

    Launch workspace session

  2. Execute the discovery checklist macro to inspect active MCP servers:

    /mcp
    
  3. Confirm that HomeDevelopers (or your chosen server name key) appears in the active connections list.

    Confirm Home Developer

  4. Ask Google Home a question, for example:

    How do I create an Automation using Home APIs?
    
  5. If Antigravity believes reading the Google Home developer documentation will help, it requests permission to use the Home Developer MCP Server's search_documents tools. Select any of the Allow options to continue.

    Allow permission

  6. After calling the tool and thinking, Antigravity will answer your query with a grounded response.

    Antigravity response

Video tutorial

Watch the video for a step-by-step guide to installing the Home Developer MCP.

Direct HTTP API Testing Protocols (cURL)

For pipeline testing outside of a client wrapper environment, standard JSON-RPC payloads can be delivered over curl channels.

Discover active system tools

curl --location "https://homedevelopers.googleapis.com/mcp" \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "id": 1
}'

Execute a functional search query

Unauthenticated

curl --location "https://homedevelopers.googleapis.com/mcp" \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "id": 2,
    "params": {
        "name": "search_documents",
        "arguments": {
            "query": "How to create an automation?"
        }
    }
}'

Authenticated

curl --location "https://homedevelopers.googleapis.com/mcp" \
--header 'Content-Type: application/json' \
--header 'Accept: application/json, text/event-stream' \
--header "X-Goog-Api-Key: "YOUR_API_KEY" \
--data '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "id": 2,
    "params": {
        "name": "search_documents",
        "arguments": {
            "query": "How to create an automation?"
        }
    }
}'

Send Feedback

Use our feedback form to submit your thoughts and suggestions about the Home Developer MCP or how we can improve your experience with the tool.

Send us your feedback