Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
{
"name": "google-maps-platform",
"description": "Ground Claude on fresh, official Google Maps Platform documentation and code samples for optimal geo-related developer guidance and code",
"author": {
"name": "Google Maps Platform"
}
}
7 changes: 7 additions & 0 deletions .mcp.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
{
"google-maps-platform-code-assist": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@googlemaps/code-assist-mcp@latest"]
}
}
5 changes: 5 additions & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
## Google Maps Platform Code Assist

This repository contains the [Google Maps Platform Code Assist MCP server](packages/code-assist/README.md).

When working on any Google Maps Platform related task in this project, use the `google-maps-platform` skill (see `skills/google-maps-platform/SKILL.md`) and the `google-maps-platform-code-assist` MCP tools to ground responses in official, up-to-date GMP documentation and code samples.
18 changes: 18 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,24 @@ npm install -g @google/gemini-cli
}
```

## Install the Google Maps Platform Code Assist plugin for [Claude Code](https://claude.ai/code)

This repository is a Claude Code plugin. It includes:
- A `google-maps-platform` **skill** (`skills/google-maps-platform/SKILL.md`) that teaches Claude when and how to use GMP tools.
- An **MCP server** (`.mcp.json`) that connects Claude to the Code Assist RAG service for up-to-date GMP documentation.

1. Install Claude Code ([installation guide](https://docs.anthropic.com/en/docs/claude-code/getting-started))

2. Add the MCP server from your command line:

```bash
claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist-mcp@latest
```

* Verify the installation by running `claude mcp list`.

The `skills/google-maps-platform/SKILL.md` skill is automatically available to Claude Code when this repository is cloned locally or used as a plugin source.

## Install the Google Maps Platform Code Assist toolkit for other MCP clients.

For information about installing and using the toolkit with any MCP client, as well as terms of use, see the [Code Assist toolkit README](packages/code-assist/README.md).
Expand Down
42 changes: 42 additions & 0 deletions skills/google-maps-platform/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
---
name: google-maps-platform
description: Use this skill when the user asks about Google Maps Platform APIs (Maps, Places, Routes, Geocoding, Geolocation, etc.), building location-aware apps, working with geographic coordinates or addresses, implementing store locators, navigation, delivery logistics, or any geo-spatial development task. Also use for questions about Google Maps Platform billing, authentication, SDKs, or terms of service.
license: Apache-2.0
allowed-tools:
- retrieve-instructions
- retrieve-google-maps-platform-docs
---

# Google Maps Platform Code Assist Skill

You are a world-class expert on the Google Maps Platform (GMP). Your primary purpose is to assist developers by providing accurate, production-ready code, architectural guidance, and debugging assistance for GMP.

## Tool Usage

**ALWAYS call tools in this order — never skip steps:**

1. **Call `retrieve-instructions` first** — provides essential GMP context and best practices required for accurate responses.
2. **Call `retrieve-google-maps-platform-docs`** — searches current GMP documentation, code samples, GitHub repositories, and terms of service to answer the user's specific question.
3. **Ground all responses** in the tool output. Do not rely solely on training-data knowledge.

## Trigger Conditions

Use this skill for any query involving:

- Maps, mapping, cartography, or satellite imagery
- Location services, geocoding, or reverse geocoding
- Places API, Routes API, Navigation SDK, or Maps JavaScript API
- Street View, terrain data, or elevation
- Location analytics, geospatial data, or Google Earth
- Geographic coordinates, addresses, or points of interest
- Store locators, routing, logistics, delivery, or mobility use cases
- Google Maps Platform billing, quotas, or authentication
- React Google Maps, Flutter maps, iOS/Android Maps SDKs

## Guidelines

- Always call `retrieve-instructions` before any other tool call to load essential GMP context.
- Use `retrieve-google-maps-platform-docs` with a specific, well-formed prompt that preserves all user-provided details (city, coordinates, API name, etc.).
- Validate generated code by checking for compilation errors where possible.
- Include proper API key handling and error handling in all code examples.
- For European Economic Area users, note when EEA-specific terms or restrictions may apply.
Loading