developer-toolsoauth2

Google Maps

Integrate Google Maps to access location data, geocoding, directions, and mapping services in your application.

Verdict

The Google Maps MCP brings location intelligence into your Switchy workspace. @mention it to calculate travel times between multiple points, generate embeddable maps for client presentations, search for nearby venues when planning team offsites, or pull turn-by-turn directions without leaving your conversation. Sales teams use it to map prospect territories, support teams to estimate delivery windows, and event planners to compare venue options. OAuth setup requires a Google Cloud project with Maps API enabled and billing configured — free tier covers most small-team usage, but you'll need a credit card on file.

Common use cases

  • Map prospect locations for territory planning
  • Calculate delivery windows for customer support
  • Find meeting venues near client offices
  • Generate embeddable maps for proposals
  • Compare commute times for office relocation

Integration

Vendor
Google Maps
Category
developer-tools
Auth
OAUTH2
Tools
7
Composio slug
google_maps

Tools

  • Distance Matrix

    Calculates travel distance and time for a matrix of origins and destinations. supports different modes of transportation and options like departure/arrival times. use when needing to determine travel metrics between multiple points.

  • Embed Google Map

    Tool to generate an embeddable google map url and html iframe code. use when you need to display a map (place, view, directions, street view, search) on a webpage without javascript.

  • Geocoding, Reverse Geocoding, and Place ID Lookup

    Deprecated: tool to convert addresses into geographic coordinates (latitude and longitude) and vice versa (reverse geocoding), or get an address for a place id. use for finding coordinates for an address, finding an address for coordinates,

  • Get directions

    Fetches detailed directions between an origin and a destination, supporting intermediate waypoints and various travel modes.

  • Get Route

    Calculates one or more routes between two specified locations using various travel modes and preferences; addresses must be resolvable by google maps.

  • Nearby search

    Searches for places (e.g., restaurants, parks) within a specified circular area, with options to filter by place types and customize the returned fields and number of results.

  • Text Search

    Searches for places on google maps using a textual query (e.g., "restaurants in london", "eiffel tower").

Setup

Setup guide

  1. 11. In Switchy, open your workspace settings and navigate to Integrations. 2. Click 'Add Integration' and select Google Maps from the developer tools category. 3. You'll be redirected to Google's OAuth consent screen — sign in with a Google account that has access to a Cloud project with the Maps JavaScript API, Geocoding API, Directions API, Distance Matrix API, and Places API enabled. 4. Grant Switchy permission to access these APIs on your behalf (no personal data is shared, only API call authorization). 5. After redirecting back to Switchy, you'll see 'Google Maps connected' in your integrations list. 6. Open any Space, type '@Google Maps find coffee shops near 123 Main St, Austin TX' and send — if the MCP returns results, your connection works. 7. To invoke specific tools, address the MCP directly in your message (e.g., '@Google Maps calculate drive time from our office to the airport').

What teammates see: by default, memories from Google Maps are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Territory Travel Times

@Google Maps calculate driving distance and time from 500 Howard St, San Francisco CA to these five addresses: 1 Market St SF, 201 Mission St SF, 345 California St SF, 50 Fremont St SF, 100 Pine St SF
Open in a Space →

Client Directions

@Google Maps get detailed driving directions from San Francisco International Airport to our office at 123 Market St, San Francisco CA including estimated travel time
Open in a Space →

Embeddable Map

@Google Maps generate an embeddable map centered on the Eiffel Tower in Paris with a satellite view at zoom level 15, and give me the HTML iframe code
Open in a Space →

Multi-Stop Route

@Google Maps calculate the best driving route from our warehouse at 789 Industrial Blvd, Austin TX through these three delivery addresses: 100 Congress Ave, 200 Lavaca St, 300 Brazos St, then back to the warehouse
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@google-maps find the top 5 coffee shops within 2km of the Eiffel Tower and show me their ratings and opening hours

Output

Found 5 coffee shops near the Eiffel Tower: (1) Café de l'Homme (4.2★, opens 12pm-11pm daily), (2) Carette (4.4★, opens 7:30am-11pm), (3) Le Café du Trocadéro (3.9★, opens 8am-10pm), (4) Café Kléber (4.1★, opens 7am-midnight), (5) Angelina Paris Rivoli (4.3★, opens 9am-7pm weekdays, 8:30am-7pm weekends). All locations include place IDs for further queries and current operational status. This illustrative example shows typical nearby search results; actual availability and ratings vary by query time.

Notes

This example uses the Nearby Search tool to demonstrate location-based discovery. Requires OAuth2 consent for Places API access. Results depend on Google's current place database and may return fewer matches if the radius or type filters are too restrictive. Rate limits apply per project quota.

Prompt

@google-maps calculate driving time from San Francisco to Los Angeles with a departure at 8am Friday, and compare it to the same trip leaving at 2pm

Output

8am Friday departure: 6 hours 15 minutes (383 miles) via I-5 S, accounting for typical morning traffic clearing by 10am. 2pm Friday departure: 7 hours 45 minutes (same route), with heavy congestion through San Jose and into LA metro area between 4-6pm. The morning departure saves approximately 90 minutes. Distance Matrix also provides fuel cost estimates if enabled. This illustrative comparison shows how departure time affects travel duration; actual conditions depend on real-time traffic data at query time.

Notes

This example showcases the Distance Matrix tool's ability to factor departure time into travel calculations. Requires traffic model parameters (best_guess, optimistic, pessimistic) to be specified. Results are estimates based on historical and live traffic patterns, not guarantees. API quota consumed per origin-destination pair.

Prompt

@google-maps generate turn-by-turn directions from Boston Common to Harvard Square via MIT, then create an embeddable map I can drop into our team wiki

Output

Route generated: (1) Head northwest on Tremont St toward Park St (0.2 mi), (2) Turn right onto Cambridge St (1.1 mi), (3) Continue to Massachusetts Ave toward MIT (2.3 mi), (4) Turn left onto Memorial Drive, destination on right (1.8 mi). Total: 5.4 miles, ~18 minutes by car. Embed code: `<iframe src="https://www.google.com/maps/embed/v1/directions?origin=Boston+Common&destination=Harvard+Square&waypoints=MIT&key=YOUR_KEY" width="600" height="450"></iframe>`. This illustrative output combines routing with embed generation; actual HTML requires your API key substitution.

Notes

This example pairs Get Directions with Embed Google Map to show multi-tool workflows. The embed tool generates static HTML that works without JavaScript, ideal for documentation sites. Waypoints are limited to 25 per request. Embedding requires a valid API key with Maps Embed API enabled, separate from the MCP's OAuth2 scope.

Use-case deep-dives

Field service routing for dispatch teams

When Google Maps MCP handles same-day dispatch scheduling

A 6-person HVAC dispatch team runs morning routing calls where they assign 15-20 service tickets across three techs. The Distance Matrix tool calculates drive times between every job pair in under two seconds, and Get Route returns turn-by-turn sequences the dispatcher pastes into the tech's chat thread. This works cleanly when your service area fits in a single metro region and ticket addresses are already validated—Google's geocoder chokes on apartment unit numbers or rural route boxes about 8% of the time, so you'll manually fix a couple addresses per batch. If your team dispatches more than 40 jobs daily or optimizes across multiple service windows, you need a dedicated routing engine; this MCP is the right call for straightforward same-day sequencing where a human still eyeballs the final route order.

Customer support location troubleshooting

Why this MCP speeds up 'where is my delivery' tickets

A 4-person e-commerce support team fields 30-50 'package not delivered' tickets daily, and half require checking whether the carrier's GPS drop matches the customer's address. The Geocoding tool converts the customer's address and the carrier's lat-long into comparable coordinates in one API call, and Reverse Geocoding confirms the drop point's street name when the coordinates land 200 feet away at a neighbor's porch. This cuts a 90-second Google search down to 12 seconds and eliminates the copy-paste errors that happen when agents toggle between Zendesk and a browser tab. The OAuth2 setup takes 20 minutes the first time—your IT admin creates the Google Cloud project and drops the credentials into Switchy—but after that it's zero-touch. If your support volume is under 100 location checks per day, this MCP is faster than building a custom integration.

Sales territory planning for regional reps

When Nearby Search beats manual prospecting lists

A 3-rep sales team covering the Pacific Northwest spends Monday mornings building weekly prospect lists by searching 'dental practices within 15 miles of Seattle' and similar queries for each territory. The Nearby Search tool returns 20 results per query with phone numbers and addresses already formatted, and the Text Search tool handles multi-keyword queries like 'urgent care open Sundays Portland' without the rep needing to learn Google's place-type taxonomy. This replaces 45 minutes of browser tabs and spreadsheet copy-paste with a 6-minute AI conversation that outputs a CSV the reps import into their CRM. The tool count is low—7 total—so there's no decision fatigue about which endpoint to call, and the OAuth2 token refresh happens automatically after the first login. If your territories shift weekly or you prospect more than 100 locations per session, this MCP keeps your list-building inside the same workspace where you draft outreach emails.

Frequently asked

What does the Google Maps MCP do in Switchy?

It lets your AI agents search for places, calculate routes, get directions, and embed maps without leaving the conversation. The MCP wraps seven Google Maps API endpoints — text search, nearby search, distance matrix, geocoding, route calculation, directions, and map embedding. Your team can ask the AI to find restaurants near an address, compute drive times between multiple locations, or generate an iframe for a custom map view.

Which OAuth scopes does the Google Maps MCP request?

Google Maps APIs typically use API key authentication, not OAuth scopes. When you connect this MCP in Switchy, you'll provide a Google Cloud project API key with the Maps JavaScript API, Places API, Directions API, and Distance Matrix API enabled. You don't grant user-level permissions; the key bills usage to your Google Cloud account. Make sure billing is enabled on the project or requests will fail.

Can the MCP book reservations or write reviews on Google Maps?

No. The MCP is read-only for place data and route calculation; it can't post reviews, claim businesses, or make reservations. If you need to update place information or interact with user-generated content, you'll have to use the Google My Business API separately or handle those actions outside Switchy. This MCP is for querying and displaying map data, not modifying it.

How does using this MCP compare to calling the Google Maps API directly?

The MCP abstracts away request formatting and error handling, so your AI agents can call "nearby search" in natural language instead of constructing HTTP requests. You still pay Google's per-request pricing and hit the same rate limits. The trade-off: you lose fine-grained control over request parameters, but you gain speed and simplicity when the AI needs map data mid-conversation without custom code.

Who on the team should connect the Google Maps MCP?

Whoever owns your Google Cloud project and can generate an API key with billing enabled. That person doesn't need to be a Switchy admin, but they do need console.cloud.google.com access. Once the key is added to Switchy, any team member can invoke the MCP's tools in their chats. Usage charges appear on your Google Cloud bill, not your Switchy subscription.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.