# How to connect Google Maps to Muse

```json
{
  "title": "How to connect Google Maps to Muse",
  "toolkit": "Google Maps",
  "toolkit_slug": "google_maps",
  "framework": "Muse",
  "framework_slug": "muse",
  "url": "https://composio.dev/toolkits/google_maps/framework/muse",
  "markdown_url": "https://composio.dev/toolkits/google_maps/framework/muse.md",
  "updated_at": "2026-10-04T16:40:46.062Z"
}
```

## Introduction

Muse is Meta's AI assistant. It can connect to outside tools through custom connectors, which use the Model Context Protocol (MCP).
This guide explains how to connect Google Maps to Muse using Composio Connect, which handles OAuth, token refresh, and reliability so you do not have to. You add Composio as a custom connector once, then ask Muse to work with Google Maps in plain language.

## Also integrate Google Maps with

- [Claude Code](https://composio.dev/toolkits/google_maps/framework/claude-code)
- [Cursor](https://composio.dev/toolkits/google_maps/framework/cursor)
- [ChatGPT](https://composio.dev/toolkits/google_maps/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/google_maps/framework/claude-cowork)
- [Antigravity](https://composio.dev/toolkits/google_maps/framework/antigravity)
- [OpenAI Agents SDK](https://composio.dev/toolkits/google_maps/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/google_maps/framework/claude-agents-sdk)
- [Grok Bot](https://composio.dev/toolkits/google_maps/framework/grok-bot)
- [Codex](https://composio.dev/toolkits/google_maps/framework/codex)
- [Grok Build](https://composio.dev/toolkits/google_maps/framework/grok-build)
- [VS Code](https://composio.dev/toolkits/google_maps/framework/vscode)
- [OpenCode](https://composio.dev/toolkits/google_maps/framework/opencode)
- [OpenClaw](https://composio.dev/toolkits/google_maps/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/google_maps/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/google_maps/framework/atomic-agent)
- [Pi](https://composio.dev/toolkits/google_maps/framework/pi-agent)
- [DeepSeek Harness](https://composio.dev/toolkits/google_maps/framework/deepseek)
- [Google ADK](https://composio.dev/toolkits/google_maps/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/google_maps/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/google_maps/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/google_maps/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/google_maps/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/google_maps/framework/crew-ai)
- [Pydantic AI](https://composio.dev/toolkits/google_maps/framework/pydantic-ai)
- [AutoGen](https://composio.dev/toolkits/google_maps/framework/autogen)

## TL;DR

- Cross-app workflows across 1,500+ apps from a single plugin layer.
- On-demand tool loading so Muse only loads the tools needed for the current task.
- Programmatic tool calling through a remote workbench for complex, multi-step workflows.
- Multi-account support so users can connect and switch between multiple accounts for the same app.
- Shared account access so teams or agents can work through common business accounts and service connections.
- Managed authentication with OAuth handling, credential storage, and token refresh managed by Composio.
- Safer credential handling so app credentials stay outside the model context and tool responses.
- User-level account isolation so actions run against the correct connected account instead of mixing user access.

## Connect Google Maps to Muse

### Connecting Google Maps to Muse
You add Composio to Muse once as a custom connector, then connect Google Maps from the chat.

## What is the Google Maps MCP server, and what's possible with it?

The Google Maps MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Google Maps account. It provides structured and secure access to place and location data, so your agent can search for places, geocode addresses, compare travel times, retrieve place details, and create map content on your behalf.
- Place search and suggestions: Have your agent find places from natural language searches or suggest matching locations as you type.
- Address and coordinate lookup: Let the agent convert addresses into coordinates, turn coordinates into readable addresses, or look up a location from a known place.
- Travel distance and time comparison: Direct your agent to compare travel distances and durations across multiple starting points and destinations using different travel modes.
- Place details, photos, and time zones: Instruct your agent to retrieve useful place information, fetch location photos, or identify the time zone for specific coordinates.
- Maps and aerial content: Have your agent generate an embeddable Google Map or request an aerial view video for a US postal address.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `GOOGLE_MAPS_AUTOCOMPLETE` | Autocomplete Place Predictions | Returns place and query predictions for text input. Use when implementing as-you-type autocomplete functionality for place searches. Returns up to five predictions ordered by relevance. |
| `GOOGLE_MAPS_COMPUTE_ROUTE_MATRIX` | Compute Route Matrix | Calculates travel distance and duration matrix between multiple origins and destinations using the modern Routes API; supports OAuth2 authentication and various travel modes. Matrix is capped at 625 elements (e.g., 25×25); chunk larger sets to avoid RESOURCE_EXHAUSTED errors. Response elements may be returned out of input order — always use originIndex and destinationIndex to map results. Only use elements where condition='ROUTE_EXISTS'; the matrix may be incomplete. |
| `GOOGLE_MAPS_GEOCODE_ADDRESS_WITH_QUERY` | Geocode Address With Query | Tool to map addresses to geographic coordinates with query parameter. Use when you need to convert a textual address into latitude/longitude coordinates using the modern v4beta API. Results may match multiple places — always verify `formattedAddress`, `region`, and `addressComponents` in the response before using returned coordinates. |
| `GOOGLE_MAPS_GEOCODE_DESTINATIONS` | Geocode Destinations | Tool to perform destination lookup and return detailed destination information including primary place, containing places, sub-destinations, landmarks, entrances, and navigation points. Use when you need comprehensive destination data for an address, place ID, or geographic coordinates. |
| `GOOGLE_MAPS_GEOCODE_LOCATION` | Reverse Geocode Location | Tool to convert geographic coordinates (latitude and longitude) to human-readable addresses using reverse geocoding. Use when you need to find the address or place name for a given set of coordinates. A single coordinate pair may return multiple results; verify formattedAddress, region, and addressComponents before committing to a result. |
| `GOOGLE_MAPS_GEOCODE_PLACE` | Geocode Place by ID | Tool to perform geocode lookup using a place identifier to retrieve address and coordinates. Use when you need to get detailed geographic information for a specific Google Place ID. |
| `GOOGLE_MAPS_GEOCODING_API` | Geocoding API | Convert addresses into geographic coordinates (latitude and longitude) and vice versa (reverse geocoding), or get an address for a Place ID. Uses the Geocoding API v4 (v4beta) which supports OAuth2 authentication. Exactly one of `address`, `latlng`, or `place_id` must be provided per request; omitting all three or mixing incompatible combinations yields no useful results. |
| `GOOGLE_MAPS_GEOLOCATE` | Geolocate Device | Tool to determine location based on cell towers and WiFi access points. Use when you need to find the geographic location of a device using network infrastructure data. |
| `GOOGLE_MAPS_GET2D_TILE` | Get 2D Map Tile | Tool to retrieve a 2D map tile image at specified coordinates for building custom map visualizations. Use when you need to download individual map tile images for roadmap, satellite, or terrain views. Requires a valid session token from the createSession endpoint. |
| `GOOGLE_MAPS_GET3D_TILES_ROOT` | Get 3D Tiles Root | Tool to retrieve the 3D Tiles tileset root configuration for photorealistic 3D map rendering. Use when you need to initialize a 3D renderer with Google's photorealistic tiles following the OGC 3D Tiles specification. The Map Tiles API is billable per request; cache the root response client-side and avoid repeated calls. |
| `GOOGLE_MAPS_GET_PLACE_DETAILS` | Get Place Details | Retrieves comprehensive details for a place using its resource name (places/{place_id} format). Use when you need detailed information about a specific place. |
| `GOOGLE_MAPS_GET_ROUTE` | Get Route | Calculates one or more routes between two specified locations. Uses various travel modes and preferences; addresses must be resolvable by Google Maps. Response `duration` is a string with 's' suffix (e.g., `"4557s"`); parse before displaying. |
| `GOOGLE_MAPS_LOOKUP_AERIAL_VIDEO` | Lookup Aerial Video | Tool to look up an aerial view video by address or video ID. Returns video metadata including state and URIs for playback. Use when you need to retrieve a previously rendered aerial video or check the status of a video render request. Note that receiving a video is a billable event. |
| `GOOGLE_MAPS_MAPS_EMBED_API` | 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. Note: This API only works with API keys (no OAuth2 support). It generates embed URLs and does not make direct API calls. Generated embed URLs are publicly accessible; avoid passing sensitive or internal location queries. |
| `GOOGLE_MAPS_NEARBY_SEARCH` | 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. |
| `GOOGLE_MAPS_PLACE_PHOTO` | Get Place Photo | Retrieves high quality photographic content from the Google Maps Places database. Use when you need to download a place photo using a photo_reference obtained from Place Details, Nearby Search, or Text Search requests. Images are scaled proportionally to fit within specified dimensions. |
| `GOOGLE_MAPS_RENDER_AERIAL_VIDEO` | Render Aerial Video | Starts rendering an aerial view video for a US postal address. Returns a video ID that can be used with lookupVideo to retrieve the video once rendering completes. Rendering typically takes up to a few hours. |
| `GOOGLE_MAPS_TEXT_SEARCH` | Text Search | Searches for places on Google Maps using a textual query (e.g., "restaurants in London", "Eiffel Tower"). Results may include CLOSED_PERMANENTLY or TEMPORARILY_CLOSED places — filter by businessStatus=OPERATIONAL. Include city/region and business type in textQuery to avoid empty or irrelevant results. Deduplicate using id or formattedAddress, not name alone. Throttle to ~1 req/s; OVER_QUERY_LIMIT (HTTP 429) requires exponential backoff. |
| `GOOGLE_MAPS_TILES_CREATE_SESSION` | Create Tiles Session | Tool to create a session token required for accessing 2D Tiles and Street View imagery. Use when you need to initialize tile-based map rendering or street view display. The session token is valid for approximately two weeks and must be included in all subsequent tile requests. Each call consumes quota — cache and reuse the returned token across all tile requests within its validity window rather than creating a new session per request. |

## Supported Triggers

None listed.

## Troubleshooting

### 1. Why doesn't Muse show a button to add my API key?

Muse shows the button only when you ask it to open the secure credentials store.
- Start a new chat.
- Send the message from step 1 exactly as written.
- If Muse asks for the key in the chat, do not paste it. Ask Muse to open the secure credentials store.

### 2. Why does the Composio connection fail after I add my API key?

The key or the connector settings are not correct.
- Copy the full key from the Composio dashboard. It starts with ck_.
- Make sure the URL is https://connect.composio.dev/mcp and the header is x-consumer-api-key.
- Remove the Composio connector in Muse settings, then do steps 1 to 3 again.

### 3. Why doesn't Muse use the Composio tools for Google Maps?

Muse may not pick the Composio connector for the request.
- Ask Muse to list its Composio tools.
- Name Composio and Google Maps in your request, for example: Use Composio to connect to Google Maps.
- If it still does not work, start a new chat and try again.

### 4. Why does Muse ask me to connect Google Maps again?

Your Google Maps connection expired or was removed.
- Open the link Muse gives you and sign in to Google Maps again.
- Check that the Google Maps connection shows as ACTIVE in the Composio dashboard.

### 5. What do I do if I pasted my API key into the chat?

Treat the key as exposed.
- Create a new API key in the Composio dashboard and delete the old one.
- Add the new key in Muse's secure credentials store, not in the chat.

## Creating MCP Server - Stand-alone vs Composio SDK

Once connected, Muse can access the Google Maps MCP server through Composio to run the actions you authorize, using plain language in the chat.

## Complete Code

None listed.

## Conclusion

### Way Forward
Now that Google Maps is connected, extend your setup by connecting the other apps you already use every day, so Muse can run true cross-app workflows end to end.
- Connect Calendar to turn threads into scheduled meetings automatically.
- Connect Slack or Teams to post summaries, approvals, and alerts where your team works.
- Connect Notion, Linear, Jira, or Asana to convert requests into tickets, tasks, and docs.
- Connect Drive, Dropbox, or OneDrive to fetch, file, and share attachments without manual steps.
Start with one workflow you do repeatedly, then keep adding apps as you find new handoffs. With everything behind a single connection, Muse can coordinate multiple tools safely and reliably in one conversation.

## How to build Google Maps MCP Agent with another framework

- [Claude Code](https://composio.dev/toolkits/google_maps/framework/claude-code)
- [Cursor](https://composio.dev/toolkits/google_maps/framework/cursor)
- [ChatGPT](https://composio.dev/toolkits/google_maps/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/google_maps/framework/claude-cowork)
- [Antigravity](https://composio.dev/toolkits/google_maps/framework/antigravity)
- [OpenAI Agents SDK](https://composio.dev/toolkits/google_maps/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/google_maps/framework/claude-agents-sdk)
- [Grok Bot](https://composio.dev/toolkits/google_maps/framework/grok-bot)
- [Codex](https://composio.dev/toolkits/google_maps/framework/codex)
- [Grok Build](https://composio.dev/toolkits/google_maps/framework/grok-build)
- [VS Code](https://composio.dev/toolkits/google_maps/framework/vscode)
- [OpenCode](https://composio.dev/toolkits/google_maps/framework/opencode)
- [OpenClaw](https://composio.dev/toolkits/google_maps/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/google_maps/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/google_maps/framework/atomic-agent)
- [Pi](https://composio.dev/toolkits/google_maps/framework/pi-agent)
- [DeepSeek Harness](https://composio.dev/toolkits/google_maps/framework/deepseek)
- [Google ADK](https://composio.dev/toolkits/google_maps/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/google_maps/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/google_maps/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/google_maps/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/google_maps/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/google_maps/framework/crew-ai)
- [Pydantic AI](https://composio.dev/toolkits/google_maps/framework/pydantic-ai)
- [AutoGen](https://composio.dev/toolkits/google_maps/framework/autogen)

## Related Toolkits

- [Excel](https://composio.dev/toolkits/excel) - Microsoft Excel is a robust spreadsheet application for organizing, analyzing, and visualizing data. It's the go-to tool for calculations, reporting, and flexible data management.
- [21risk](https://composio.dev/toolkits/_21risk) - 21RISK is a web app built for easy checklist, audit, and compliance management. It streamlines risk processes so teams can focus on what matters.
- [Abstract](https://composio.dev/toolkits/abstract) - Abstract provides a suite of APIs for automating data validation and enrichment tasks. It helps developers streamline workflows and ensure data quality with minimal effort.
- [AccuWeather](https://composio.dev/toolkits/accu_weather) - AccuWeather is a global weather service providing current conditions, forecasts, MinuteCast precipitation, alerts, and lightning data. Use it for fast, localized forecasts and real-time weather alerts.
- [Adafruit IO](https://composio.dev/toolkits/adafruit_io) - Adafruit IO is Adafruit's cloud platform for connected device and IoT project data. It helps you store, visualize, and act on sensor feeds without running your own backend.
- [Addressfinder](https://composio.dev/toolkits/addressfinder) - Addressfinder is a data quality platform for verifying addresses, emails, and phone numbers. It helps you ensure accurate customer and contact data every time.
- [Agentql](https://composio.dev/toolkits/agentql) - Agentql is a toolkit that connects AI agents to the web using a specialized query language. It enables structured web interaction and data extraction for smarter automations.
- [Agenty](https://composio.dev/toolkits/agenty) - Agenty is a web scraping and automation platform for extracting data and automating browser tasks—no coding needed. It streamlines data collection, monitoring, and repetitive online actions.
- [Ambee](https://composio.dev/toolkits/ambee) - Ambee is an environmental data platform providing real-time, hyperlocal APIs for air quality, weather, and pollen. Get precise environmental insights to power smarter decisions in your apps and workflows.
- [Ambient weather](https://composio.dev/toolkits/ambient_weather) - Ambient Weather is a platform for personal weather stations with a robust API for accessing local, real-time, and historical weather data. Get detailed environmental insights directly from your own sensors for smarter apps and automations.
- [Anonyflow](https://composio.dev/toolkits/anonyflow) - Anonyflow is a service for encryption-based data anonymization and secure data sharing. It helps organizations meet GDPR, CCPA, and HIPAA data privacy compliance requirements.
- [ApexVerify](https://composio.dev/toolkits/apexverify) - ApexVerify is a contact-data validation service for emails and phone numbers. Use it to normalize, verify, and clean leads before they enter your systems.
- [Api ninjas](https://composio.dev/toolkits/api_ninjas) - Api ninjas offers 120+ public APIs spanning categories like weather, finance, sports, and more. Developers use it to supercharge apps with real-time data and actionable endpoints.
- [Api sports](https://composio.dev/toolkits/api_sports) - Api sports is a comprehensive sports data platform covering 2,000+ competitions with live scores and 15+ years of stats. Instantly access up-to-date sports information for analysis, apps, or chatbots.
- [Apify](https://composio.dev/toolkits/apify) - Apify is a cloud platform for building, deploying, and managing web scraping and automation tools called Actors. It lets you automate data extraction and workflow tasks at scale—no infrastructure headaches.
- [Beach Day API](https://composio.dev/toolkits/beach_day_api) - Beach Day API is a beach intelligence service for search, conditions, scores, rules, amenities, tides, and country coverage. Use it to power trip planning, surf reports, safety checks, and location-aware beach discovery.
- [Big data cloud](https://composio.dev/toolkits/big_data_cloud) - BigDataCloud provides APIs for geolocation, reverse geocoding, and address validation. Instantly access reliable location intelligence to enhance your applications and workflows.
- [Bigpicture io](https://composio.dev/toolkits/bigpicture_io) - BigPicture.io offers APIs for accessing detailed company and profile data. Instantly enrich your applications with up-to-date insights on 20M+ businesses.
- [Bitquery](https://composio.dev/toolkits/bitquery) - Bitquery is a blockchain data platform offering indexed, real-time, and historical data from 40+ blockchains via GraphQL APIs. Get unified, reliable access to complex on-chain data for analytics, trading, and research.
- [Brightdata](https://composio.dev/toolkits/brightdata) - Brightdata is a leading web data platform offering advanced scraping, SERP APIs, and anti-bot tools. It lets you collect public web data at scale, bypassing blocks and friction.

## Frequently Asked Questions

### Does Muse support MCP?

Yes. Muse supports custom connectors that use the Model Context Protocol (MCP). Composio connects as one custom connector over remote streamable HTTP at https://connect.composio.dev/mcp, and gives Muse access to Google Maps and 1,500+ other apps.

### Where do I get the API key for the Composio connector?

Copy it from the Composio dashboard. It starts with ck_. Enter it only in Muse's secure credentials store, never in the chat.

### Can I connect more than one Google Maps account to Muse?

Yes. Composio supports multiple connected accounts for the same app. Give each Google Maps connection a name, such as work or personal, and tell Muse which one to use.

### How safe is my Google Maps data with Composio?

Tokens, keys, and configuration are encrypted at rest and in transit. Your Composio API key stays in Muse's secure credentials store, not in the chat or the model context. Composio is SOC 2 Type 2 compliant.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)