Google Maps MCP Server

Ein gehosteter Model Context Protocol (MCP)-Server, der Claude, Cursor, Windsurf und jedem anderen MCP-Client sechs schreibgeschützte Google-Maps-Tools bietet. Orte suchen, einen Ort vollständig lesen, Bewertungen, Fotos und Beiträge abrufen und die Historie eines einzelnen Bewerters durchgehen – alles als strukturiertes JSON, ohne Google-Cloud-Projekt und ohne aktivierte Abrechnung.

https://mcp.hasdata.com/api/mcp?apis=google_maps

Inhalt

• Was du brauchst

• Schnellstart

• Beispiel-Prompts

• Tools

• Fehler und Fehlerpfade

• Preise, kostenloses Kontingent und Limits

• Tool-Auswahl

• Vergleich

• FAQ

• HasData-Links

• Entwicklung

• Mitwirken

• Lizenz

Related MCP server: MCP Google Maps

Was du brauchst

Ein MCP-Client, der streamable HTTP mit benutzerdefinierten Headern spricht. Ein HasData-API-Schlüssel aus dem Dashboard, kostenlos ohne Karte zu erstellen, und die Testversion deckt etwa 200 Aufrufe zum 5-Credits-Satz ab. Sonst nichts. Dies ist ein Remote-Server, der einfachste Weg ist also eine URL und ein Header, ohne Container, den man ausführen muss, und ohne Google-Cloud-Projekt oder API-Schlüssel irgendwo im Ablauf. Ein reiner stdio-Client kann stattdessen den @hasdata/google-maps-mcp- (npm) oder hasdata-google-maps-mcp-Launcher (PyPI) verwenden.

Schnellstart

Die Server-URL ist für jeden Client gleich. Wir betreiben ihn praktisch in Claude Code und Claude Desktop. Die anderen Blöcke folgen dem jeweils dokumentierten Format des Clients für einen Remote-Server.

Clients mit OAuth-Unterstützung können dieselbe URL als Connector hinzufügen und sich anmelden, ohne einen Schlüssel in eine Konfigurationsdatei zu legen.

claude mcp add --transport http google-maps "https://mcp.hasdata.com/api/mcp?apis=google_maps" \
  --header "x-api-key: HASDATA_API_KEY"

Claude Desktop lädt nur lokale (stdio) Server aus seiner Konfigurationsdatei, erreicht einen Remote-Server also über einen stdio-Launcher. Das Paket @hasdata/google-maps-mcp ist dieser Launcher und liest den Schlüssel aus der Umgebung.

claude_desktop_config.json:

{
  "mcpServers": {
    "google-maps": {
      "command": "npx",
      "args": ["-y", "@hasdata/google-maps-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

Python statt Node? Tausche den Launcher gegen das PyPI-Paket, das uvx ohne manuelle Installation ausführt:

{
  "mcpServers": {
    "google-maps": {
      "command": "uvx",
      "args": ["hasdata-google-maps-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

Ein Client mit OAuth-Unterstützung kann stattdessen die URL als benutzerdefinierten Connector hinzufügen und den Launcher überspringen.

.cursor/mcp.json:

{
  "mcpServers": {
    "google-maps": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=google_maps",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "google-maps": {
      "serverUrl": "https://mcp.hasdata.com/api/mcp?apis=google_maps",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "google-maps": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=google_maps",
      "type": "streamableHttp",
      "headers": { "x-api-key": "HASDATA_API_KEY" },
      "disabled": false
    }
  }
}

.vscode/mcp.json:

{
  "servers": {
    "google-maps": {
      "type": "http",
      "url": "https://mcp.hasdata.com/api/mcp?apis=google_maps",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

~/.gemini/settings.json:

{
  "mcpServers": {
    "google-maps": {
      "httpUrl": "https://mcp.hasdata.com/api/mcp?apis=google_maps",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

Beispiel-Prompts

Jeder dieser Aufrufe ist ein einzelner Tool-Aufruf, sofern die Anzahl nichts anderes angibt.

Suche bei Google Maps nach Kaffee in der Nähe der Innenstadt von Seattle und nenne mir die Top Ten mit Bewertung, Anzahl der Bewertungen und Website.

Ein Aufruf, 5 Credits. Die Suche liefert die Orte mit bereits angehängtem placeId und dataId, und die folgenden Folgeaufrufe benötigen keinen Lookup-Schritt.

Rufe die vollständigen Details für ChIJAb0KE0RrkFQRuI4X0By5Mcw ab: Öffnungszeiten, Serviceoptionen, Preisklasse und den Menü-Link.

Ein Aufruf, 5 Credits.

Lies die neuesten Bewertungen für diesen Ort, neueste zuerst sortiert, und sag mir, welche Themen am häufigsten vorkommen.

Ein Aufruf, 5 Credits. Die Antwort enthält Googles eigene Themen-Cluster mit jeweils einer Erwähnungsanzahl, und die Rangfolge steckt in den Daten.

Nimm den Autor der Top-Bewertung und liste jeden anderen Ort auf, den er bewertet hat, mit der abgegebenen Bewertung.

Ein Aufruf, 5 Credits. Eine Bewertung trägt die contributorId ihres Autors, genau das, was das Contributor-Tool erwartet.

Hole den Foto-Feed für diesen Ort und die aktuellen Beiträge des Unternehmens.

Zwei Aufrufe. Fotos kosten 5 Credits, Beiträge 10.

Zwei Dinge machen diese Ketten günstig. Die Suche gibt bei jedem Ergebnis placeId und dataId zurück, und die Detail-, Bewertungs-, Foto- und Beitragsaufrufe benötigen keinen separaten Resolve-Schritt. Und eine Bewertung trägt die contributorId des Autors, was aus „Wer hat diese Bewertung hinterlassen" einen Ein-Aufruf-Sprung zur gesamten Historie dieser Person macht.

Tools

Sechs Tools, alle schreibgeschützt. Die Beispiele unten sind aus echten Aufrufen gekürzt, und die Zahlen darin ändern sich, wenn Orte Bewertungen erhalten. Lies sie als Formen. Jeder Tool-Name verlinkt auf seine Endpunkt-Referenz.

Die Beispiele sind die Nutzlast, nicht die gesamte Antwort. Ein tools/call-Ergebnis trägt einen Textblock, und dieser Text ist selbst JSON mit url, status, text und json, wobei die gescrapten Daten unter json liegen. Bei einer rohen JSON-RPC-Antwort ist der Pfad result.content[0].text, geparst, dann .json. Ein Chat-Client packt das für dich aus, Code, der direkt mit dem Endpunkt spricht, nicht.

Vier der Tools akzeptieren einen Ort entweder per placeId oder dataId. Die Suche liefert beide bei jedem Ergebnis. Der übliche Ablauf ist eine Suche, gefolgt von Detail-, Bewertungs-, Foto- oder Beitragsaufrufen, die die jeweilige ID wiederverwenden, die du behalten hast.

Google Maps durchsuchen

hasdata_google_maps_search_performMapSearch

Orte für eine Abfrage, sortiert so, wie Google Maps sie sortiert.

Jedes Ergebnis trägt position, title, placeId, dataId, address, gpsCoordinates, rating, reviews, type, types, price, website, thumbnail, openState, workingHours, serviceOptions und, wo Google einen zeigt, einen menu-Link.

Der Standort steckt in ll, nicht in der Abfrage. Setze Kartenmittelpunkt und Zoom dorthin, denn „coffee" allein liefert, wo auch immer Google entscheidet, dass du bist. Die Zoom-Ziffer vergrößert oder verkleinert das Gebiet, aus dem die Ergebnisse stammen.

{
  "localResults": [
    {
      "position": 1,
      "title": "Howdy Y'all Coffee (Central Library)",
      "placeId": "ChIJAb0KE0RrkFQRuI4X0By5Mcw",
      "dataId": "0x54906b44130abd01:0xcc31b91cd0178eb8",
      "address": "1000 4th Ave Fl 3, Seattle, WA 98104",
      "rating": 4.9,
      "reviews": 117,
      "type": "Coffee shop",
      "website": "https://howdyyallcoffee.com/",
      "workingHours": {
        "timezone": "America/Los_Angeles",
        "days": [ { "day": "Friday", "time": "10 AM–4 PM" } ]
      }
    }
  ]
}

Ortsdetails abrufen

hasdata_google_maps_place_getPlaceDetails

Ein Ort vollständig per placeId.

Gibt ein einzelnes placeResults-Objekt mit denselben Feldern zurück, die ein Suchergebnis trägt, plus ein images-Array. So erhältst du den vollständigen Datensatz eines Ortes, ohne eine Suche auszuführen, die du nicht brauchst.

Ortsbewertungen abrufen

hasdata_google_maps_reviews_getMapReviews

Der Bewertungs-Feed für einen Ort, Seite für Seite.

Gibt placeInfo, ein topics-Array, ein reviews-Array und pagination zurück. Jede Bewertung trägt reviewId, rating, snippet, date, isoDate, link, images, ein user-Objekt und, wo der Inhaber geantwortet hat, eine response.

topics ist Googles eigene Gruppierung dessen, was Bewertungen erwähnen, jeweils mit einem keyword und einer mentions-Anzahl, und die Themen kommen vorgezählt, statt dass du jede Bewertung lesen musst. Gib die id eines Themas als topicId zurück, um nur die Bewertungen zu lesen, die es erwähnen.

Das user-Objekt jeder Bewertung trägt eine contributorId. Das ist die Eingabe, die das Contributor-Tool erwartet, sodass „Wer hat das geschrieben" nur einen Aufruf von „alles, was sie geschrieben haben" entfernt ist.

{
  "placeInfo": { "title": "Howdy Y'all Coffee (Central Library)", "rating": 4.9, "reviews": 117 },
  "topics": [
    { "keyword": "earl grey matcha", "mentions": 26, "id": "bew1w_KAk5U" },
    { "keyword": "friendly baristas", "mentions": 17, "id": "FOw-91tYieQ" }
  ],
  "reviews": [
    {
      "reviewId": "…",
      "rating": 5,
      "snippet": "…",
      "isoDate": "2026-07-06T19:49:00.657Z",
      "user": { "name": "Angela Li", "contributorId": "106033685843245983748" },
      "response": { "isoDate": "2026-07-07T04:44:34.000Z", "snippet": "Thank you!! 🥺☺️" }
    }
  ],
  "pagination": { "nextPageToken": "…" }
}

Bewertungen eines Contributors abrufen

hasdata_google_maps_contributor_reviews_getMapReviews

Jede Bewertung, die eine Person geschrieben hat, über alle Orte, die sie bewertet hat.

Gibt ein contributor-Objekt mit name, level, points und einer contributions-Aufschlüsselung zurück sowie ein reviews-Array, in dem jeder Eintrag sein eigenes placeInfo trägt, und du siehst, um welchen Ort es bei jeder Bewertung geht, ohne einen zweiten Lookup. Dies ist das Tool hinter Bewerter-Glaubwürdigkeits- und Bewertungsnetzwerk-Arbeit, die der Bewertungs-Feed allein nicht leisten kann. Es liest die öffentliche Bewertungshistorie einer Person, also nutze die Ergebnisse im Rahmen von Googles Bedingungen und des für dich geltenden Rechts.

Ortsfotos abrufen

hasdata_google_maps_photos_getMapPhotos

Der Foto-Feed für einen Ort.

Gibt ein categories-Array zurück (All, Latest, Videos, Menu und ortsspezifische Kategorien), ein photos-Array, in dem jeder Eintrag image- und thumbnail-URLs enthält, sowie pagination.

Ortsbeiträge abrufen

hasdata_google_maps_posts_getMapPosts

Die eigenen Beiträge und Updates des Unternehmens in seinem Google-Eintrag.

Gibt ein posts-Array zurück.

Die meisten Orte veröffentlichen nichts, ein leeres posts-Array ist also der Normalfall. Lies die Länge ab, bevor du annimmst, dass ein Beitrag vorhanden ist.

Fehler und Fehlerpfade

Dein Client bekommt bei einem Tool-Aufruf fast nie einen HTTP-Fehlercode zu sehen. Die MCP-Ebene antwortet mit 200 und packt den Fehler in das Ergebnis, mit isError auf true und dem Grund als Text. Der Agent liest also eine Meldung, wo man eine Statuszeile erwarten würde.

Ein falscher Schlüssel erscheint als Tool-Ausgabe, nicht als fehlgeschlagene Verbindung. Das Auflisten der Tools akzeptiert jeden Schlüssel, der nicht leer, und der Client schließt den Handshake ab und zeigt Grün. Der erste Tool-Aufruf kommt dann mit isError: true zurück und dem Text HasData API error: 401 Unauthorized. Achte auf diese Zeichenkette, denn nichts früher im Ablauf meldet das Problem.

Der einzige echte HTTP-Fehler ist ein fehlender Schlüssel. Die Autorisierung läuft vor jedem Tool, und die Verbindung selbst scheitert mit 401.

Ein Argument, das das Schema bricht, wird abgewiesen, bevor es zu einem Request wird. Eine Suche ohne q kommt mit isError: true und dem Text MCP error -32602: Input validation error zurück und benennt das Feld. Es wird nichts abgerufen und nichts abgerechnet.

Ein Aufruf für Bewertungen, Fotos oder Beiträge braucht einen Ort. Diese drei akzeptieren placeId oder dataId. Sendet man keins von beiden, liefert die API 422 und benennt dabei beide Felder. Der Grund ist, dass die Anforderung konditional ist und das Schema sie nicht als einfache Pflichtliste ausdrücken kann. Gib eines davon an.

Eine Orts-ID, die nicht aufgelöst werden kann, ist ein sauberer Fehler, keine leeren Daten. Die Antwort kommt mit isError: true und HasData API error: 400 Bad Request sowie requestMetadata.status auf error. Prüfe das Flag und nicht die Array-Länge.

Ein leeres posts-Array ist echte Daten. Die meisten Einträge enthalten keine Beiträge. Der Aufruf ist also erfolgreich, mit status ok und einem leeren Array. Der Ort hat einfach nur nichts veröffentlicht.

Ergebnisse, die Daten enthalten, bringen auch eine requestMetadata.id mit, die sich im Support zu nennen lohnt, dazu html- und json-Links auf das gespeicherte Artefakt genau dieses Aufrufs.

Preise, Gratis-Tarif und Limits

Suche, Ortsdetails, Bewertungen, Bewertungen von Beitragsleisern und Fotos kosten 5 Credits pro erfolgreichem Aufruf. Beiträge kosten 10. Die Antwortgröße ändert den Preis nicht. Eine volle Seite Bewertungen kostet so viel wie eine Seite mit einer einzigen.

Der kostenlose Test lautet 1.000 Credits über 30 Tage ohne Karte, also 200 Aufrufe mit dem 5-Credits-Satz. Danach bekommt ein aktives Konto weiterhin jeden Tag 100 Credits gutgeschrieben, sobald der Kontostand unter 100 fällt. Ein Agent mit geringem Volumen läuft damit dauerhaft auf dem kostenlosen Tarif.

Bezahlte Pläne starten bei 49 $ pro Monat für 200.000 Credits, das sind 40.000 Fünf-Credits-Aufrufe. Der Preis pro Credit sinkt mit dem Volumen. Aktuelle Zahlen auf der Preisseite.

Dein Plan bestimmt auch die Nebenläufigkeit. Die Testversion erlaubt 1 Anfrage gleichzeitig, Startup 15, Business 30, Growth 50, und die Hochvolau-Paare zwischen 200 und 1.500ein. Nebenläufigkeit ist dabei die einzige Begrenzung. Es gibt keine eigene Anfragen-Pro-Minuten-Obergrenze; die Testversion wird auch nicht verlangsamt oder beschnitt. Behandle den Overflow-Fall in unbeaufasichtigem Betrieb defensiv, denn ein Agent, der über viele Orte ausgeschwärmt wird, erreicht die Obergrenze vor dir.

Paginierung kostet pro Aufruf. Bewertungen kommen etwa zehn pro Seite angezeigt, hundert Bewertungen sind also ungefähr zehn Aufrufe und 50 Credits; Fotos kommen auf zwanzig pro Seite. Mit der Testversion rennst du lange, bevor du es spürst.

Tool-Auswahl

?apis=google_maps gibt genau diese sechs Tools bekannt. Der Parameter akzeptiert eine Liste, und ?apis=google_maps,google_serp fügt zusätzlich die Google-Suche neben den Maps-Tools hinzu. Lässt du den Parameter weg, erhältst du alles, was HasData bereitstellt – aktuell 57 Tools.

Und narrow Liste ist meist der bessere Standard. Ein Modell, das aus sechs Tools auswählt, entscheidet öfter richtig als eines, das aus siebenundfünfzig wählt, und die Tool-Beschreibungen selbst kosten selbst demand in jeder Runde Kontext.

Wie er sich vergleichen lässt

Fast jeder andere Google-Maps-MCP-Server ist ein Wrapper um die offizielle Google-Maps-Plattform, und genau das ist die eigentliche Wahl, die du bewerten musst.

Diese Server rufen die Places-, Routes- und Geocoding-APIs mit deinen eigenen Google-Cloud-Zugangsdaten auf. Um einen davon zu betreiben, erstellst du ein Google-Cloud-Projekt, aktivierst die Abrechnung mit einer Karte, schaltest alle APIs ein und verwaltest einen Schlüssel samt Kontingenten. Diese Variante ist das richtige Werkzeug, wenn du Routing, Geocodierung und Adressvalidierung braist – was dieser Server nicht kann.

Dieser Server liest, was Google Maps einem Besucher anzeigt, und liefert es als geparstes JSON zurück. Es gibt kein Google-Cloud-Projekt, keine einzuschaltende Abrechnung und keine API-Kontingente zu verwalten. Außerdem erreicht er Daten, die Places-API nicht ausgibt: den vollständige Bewertungsfeed statt einer kleinen festen Stichprobe, die gesamte Geschichte eines einzelnen Beitragsers, den Foto-Feed und die Beiträge des Unternehmens.

Die Entscheidung läuft auf zwei Zeilen hinaus: Wenn du Wegbeschreibung brauchst oder eine Adresse in Koordinaten umwandeln möchtest, kann dieser Server dir nicht helfen – die eigentlichen Platform schon. Wenn du aber die Bewertungen hinter den ersten paar sehen möchtest oder wer ein Rezensent über alle von ihm bewertete Orte ist, ist die Plattform nicht, dieser Server kann.

Was dieser Server nicht nicht anbietet. Keine Routenberechnung, kein Geocoding, keine Adressvalidierung, keine Entfernungsmatrix und nichts, was schreibt. Er liest auf Karte.

Häufige Fragen (FAQ)

Was ist ein Google-Maps-MCP-Server?

Ein Server, der Google-Maps-Daten als Tools bereitstellt, die ein KI-Client aufrufen kann. Der Client sendet einen Tool-Aufruf über das Model Context Protocol, der Server holt die Daten und liefert strukturiertes und der Modell verarbeitet das Ergebnis und sieht nie eine HTML-Seite. Dieser Hier bietet sechs reine Lese-Tools und läuft remote. Der Client verbindet sich zu einer URL und startet keinen lokalen Prozess.

Gibt es einen offiziellen Google-Maps-MCP-Server?

Google gibt keinen allgemeingültigen heraus. Es gibt die Google-Maps-Plattform, eine Sammlung bezahlter APIs, die du mit deinem eigenen Google-Cloud-Projekt aufrufst, und mehrere Community-MCP-Server, die diese umwickeln. Dieser Server ist eine gehostete Alternative, die kein Cloud-Projekt braucht.

Brauche ich ein Google-Cloud-Projekt oder einen Google Maps API-Schlüssel?

Nein. Die einzige Einstätte ist dein HasData-Schlüssel. Es gibt kein Google-Cloud-Projekt zu erstellen, keine Abrechnung zu aktivieren und keine API-Kontingente zu verwalten.

Was ist der Unterschied zwischen placeId und dataId?

Es sind zwei Identifikatoren, die Google für denselben Ort nutzt. Die Suche liefert beide in jedem Ergebnis, und die Detail-, Bewertungs-, Foto- und Beitrag-Tools akzeptieren beide. Nimm den, der sich im Suchergebnis für dich richtig anfühlt, und freie ihn weiterhin.

Wie bekomme ich alle Bewertungen, nicht nur die erste Seite?

Lies pagination.nextPageToken aus jeder Antwort und gib ihn wieder als nextPageToken an, bis er nicht mehr erscheint. Jede Seite ist ein Aufruf.

Muss ich auf einem Server hosten oder ein Programm laufen lassen?

Nein. Eine ist abgelegener MCP-Server auf streameres HTTP. Nichts zu installieren, kein Python-Umgebung, keinen Prozess zum Neustarten.

Sind die Daten live oder gecacht?

Live. Jeder Aufruf friest zum Zeitpunkt der Anfrage und hat eine eigene requestMetadata.id. Zwei identische Aufrufe sind zwei getrennte Anfragen und keine Wiederholung einer gezogenen Antwortsamme.

Kann ich einen Server für mehrere Google-Oberflächen verwenden?

Ja. Der apis-Parameter nimmt eine Liste auf, und ?apis=google_maps,google_serp versorgt den Agenten mit den Maps-Tools und der Google-Suche gleichzeitig.

Abläuft der API-Schlüssel?

Nein. Der Schlüssel läuft. Er ausgegeben dich im Dashboard immer dann, wenn es nötig ist.

Ist das mit Google verknüpft?

Nein. HasData ist ein unabhängiger Dienst und ist weder von Google betrieben, noch unterstützt, noch gespendet. Das bedeutet Google und Google Maps Marken ihrer jeweiligen Eigentümer. Die Tools arbeiten nur mit öffentlich zugänglichen Daten, und du bist dafür verantwortlich, die Ergebnisse gemäß den Bestimmungen von Google und dem für dich geltenden Recht zu verwenden.

HasData-Links

Entwicklung

Dieses Repository ist Konfiguration und Dokumentation für einen Remote-Server. Es gibt keinen Build-Schritt und nichts zu containerisieren.

Es enthält einen Vertragstest. Die README verspricht sechs Tools mit bestimmten Parametern, und die Upstream-Tool-Liste kann sich ohne einen Commit hier ändern, was diese Datei stillschweigend lügen lassen würde. Der Test bestätigt das Versprechen und läuft wöchentlich in CI sowie bei jedem Push.

HASDATA_API_KEY=your_key_here npm test

In PowerShell:

$env:HASDATA_API_KEY = "your_key_here"; npm test

Der letzte Check führt einen echten Aufruf durch und kostet 5 Credits, was der Preis für einen Kanarienvogel ist, der aus dem richtigen Grund scheitern kann. Das Auflisten von Tools gelingt mit jedem nicht-leeren Schlüssel, und ein Test, der nur Tools auflistet, bleibt mit einem widerrufenen Schlüssel grün.

Mitwirken

Korrekturen an den Tool-Tabellen und den Antwortbeispielen sind der nützlichste Beitrag, da dies die Teile sind, die abweichen. Fügen Sie den von Ihnen durchgeführten Aufruf und die erhaltene Antwort hinzu. Pull-Requests von Forks führen die Suite ohne Schlüssel aus, und die Live-Checks werden übersprungen, anstatt rot zu werden.

Lizenz

MIT. Siehe LICENSE.