Cómo conectar Google Maps a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Google Maps, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Google Maps + Gemini

Deja que tu IA busque en Google Maps con tu propia clave de API: encuentra negocios y lugares por texto o alrededor de un punto, consulta su dirección, teléfono, sitio web, horario, valoración y reseñas, obtén fotos, autocompleta nombres, geocodifica direcciones y coordenadas, y calcula rutas y matrices de tiempos de viaje.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

GOOGLE_MAPS_API_KEY

Paso 1 — Obtener credenciales

1. Abre https://console.cloud.google.com, elige o crea un proyecto y vincula una cuenta de facturación. Google Maps Platform exige facturación aunque no salgas de la cuota mensual gratuita.
2. En APIs & Services → Library, habilita Places API (New), Geocoding API y Routes API. Solo necesitas las que vayas a usar, pero una llamada a una API no habilitada falla con 403.
3. Abre Google Maps Platform → Keys & Credentials → Create credentials → API key. En API restrictions, permite solo esas tres API. No añadas una restricción de sitio web (referente HTTP): las llamadas salen de un servidor, no de un navegador. Una restricción por IP solo funciona si tu servidor AnythingMCP tiene una dirección de salida fija.
4. Pega la clave en GOOGLE_MAPS_API_KEY e instala el conector. La comprobación de instalación lee un lugar con la máscara de campos gratuita que solo pide el ID. La clave se envía solo a los hosts de Maps de Google.

Se factura a tu propio proyecto de Google Cloud: cada llamada se factura al proyecto al que pertenece tu clave. Cada tipo de solicitud tiene una cuota mensual gratuita y solo pagas lo que la supera. Una alerta de presupuesto o una cuota diaria en la consola de Cloud mantienen la factura previsible.

Las máscaras de campos deciden el precio: las búsquedas de lugares y los detalles de lugares devuelven solo los campos indicados en field_mask, y Google factura la solicitud según el nivel más caro entre ellos. Precios de lista de Google para las primeras 100.000 llamadas al mes:

• Solo ID (places.id en búsquedas, id en detalles, además de photos y attributions): gratis y sin límite.
• Essentials, solo en detalles (dirección, ubicación, componentes de la dirección, tipos): unos 5 $ por cada 1.000, 10.000 gratis al mes. En las búsquedas estos campos cuentan como Pro.
• Pro (nombre, estado del negocio, enlace de Google Maps, tipo principal, zona horaria), el nivel predeterminado: búsquedas unos 32 $ por cada 1.000 con 5.000 gratis, detalles unos 17 $ por cada 1.000 con 5.000 gratis.
• Enterprise (números de teléfono, sitio web, valoración y número de valoraciones, horario, nivel de precios): búsquedas unos 35 $, detalles unos 20 $ por cada 1.000, 1.000 gratis.
• Enterprise + Atmosphere (reseñas, resúmenes de reseñas y resúmenes editoriales, servicios como comida para llevar, terraza o aparcamiento): búsquedas unos 40 $, detalles unos 25 $ por cada 1.000, 1.000 gratis.

La forma más barata de recorrer una lista larga de lugares tiene dos pasos: busca solo con places.id, que es gratis, y luego lee los detalles solo de los pocos lugares que te interesan. Consulta los precios actuales en https://developers.google.com/maps/billing-and-pricing/pricing.

Otros precios: fotos unos 7 $ por cada 1.000 (1.000 gratis). Autocompletado unos 2,83 $ por cada 1.000 solicitudes (10.000 gratis); las solicitudes de autocompletado de una sesión de búsqueda son gratis cuando la sesión termina con una llamada a los detalles de un lugar. Geocodificación unos 5 $ por cada 1.000 (10.000 gratis). Rutas y matrices de rutas unos 5 $ por cada 1.000 rutas o elementos de matriz (10.000 gratis); el tráfico en tiempo real o de 11 a 25 paradas suben una solicitud a unos 10 $, y las rutas en vehículo de dos ruedas a unos 15 $. Una matriz admite como máximo 625 pares de origen y destino, y cada par se factura como un elemento.

Qué hace: búsqueda por texto ("dentistas en Riad Al Yasmin") con filtros de tipo, valoración, precio y abierto ahora, hasta 60 resultados en tres páginas; búsqueda cercana dentro de un círculo alrededor de un punto; detalles del lugar con dirección, teléfono, sitio web, horario, valoración y reseñas; enlaces a fotos; autocompletado; geocodificación de dirección a coordenadas y al revés; rutas en coche, en bici, a pie, en vehículo de dos ruedas o en transporte público; y matrices de tiempos de viaje, por ejemplo cuál de tres técnicos está más cerca de cinco clientes.

Condiciones de Google: muestra el contenido de Google Maps con su atribución y enlaza cada lugar a su página de Google Maps (googleMapsUri); las fotos deben mostrar la atribución de sus autores. Los ID de lugar se pueden guardar para más adelante; el resto del contenido de los lugares solo se puede almacenar en caché en la medida en que lo permitan las condiciones de Google Maps Platform.

Errores habituales: 400 API_KEY_INVALID significa que la clave es incorrecta o se ha eliminado. 400 INVALID_ARGUMENT con el nombre de un campo: hay un campo mal escrito en la máscara. 403 SERVICE_DISABLED o API_KEY_SERVICE_BLOCKED: la API no está habilitada en el proyecto de la clave, o las restricciones de API de la clave la dejan fuera. 403 BILLING_DISABLED: vincula una cuenta de facturación al proyecto. 429 RESOURCE_EXHAUSTED: una cuota por minuto o un límite diario que hayas fijado en la consola.

El conector no dibuja mapas, no ofrece navegación paso a paso ni cambia nada en Google Maps: lee lugares y calcula rutas.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Google Maps.

Herramientas disponibles

Ejemplos de prompts

• "Busca restaurantes veganos a menos de 1 km de la Münsterplatz de Friburgo que estén abiertos ahora, con su valoración y sitio web."
• "Haz una lista de fontaneros en Stuttgart con número de teléfono, sitio web y valoración, y que la solicitud salga lo más barata posible."
• "¿Qué dicen las reseñas recientes de Google sobre nuestras dos tiendas en la Kaiser-Joseph-Straße?"
• "Nuestros técnicos están en Friburgo, Offenburg y Lörrach. ¿Cuál de ellos llega antes en coche a cada una de estas cinco direcciones de clientes?"

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT