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:
- Google Home Developer Center
- OpenThread
- Matter Specification: Available for version 1.5.1
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:
- Antigravity CLI: See the Getting Started with Antigravity CLI guide
- Antigravity 2.0: See the Google Antigravity Documentation
- Antigravity IDE: See the Antigravity IDE Getting Started guide
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.
- In the Google Cloud console, enable the API on your project:
- Open the Home Developers API page in the Google APIs library.
- Check that you have the correct project selected in which you intend to use the API.
- Click Enable.
Create an API Key:
- Go to the Credentials page.
- Click Create credentials, and then select API key from the menu.
- In the Name field, provide a name for the key.
Click the Select API restrictions drop-down, and then type Home Developers API. Click the result, and then click OK.
Click Create.
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)
Launch your interactive workspace session:
agy
Execute the discovery checklist macro to inspect active MCP servers:
/mcpConfirm that HomeDevelopers (or your chosen server name key) appears in the active connections list.

Ask Google Home a question, for example:
How do I create an Automation using Home APIs?If Antigravity believes reading the Google Home developer documentation will help, it requests permission to use the Home Developer MCP Server's
search_documentstools. Select any of the Allow options to continue.
After calling the tool and thinking, Antigravity will answer your query with a grounded 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.