Which integrations are available for this server?

Provides tools for searching businesses, attractions, and services on Google Maps, retrieving structured place details including ratings, contact info, coordinates, and Google Maps URLs.

How do I use Google Maps MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Google Maps MCP Server Find me the top-rated pizza places in Brooklyn" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

de en es ja ko ru zh

Google Maps MCP Server

by devsanthoshmk

Overview Schema Related Servers Score Discussions

Python

Hybrid

🗺️ Google Maps MCP Server (`gmaps-mcp`)

MCP Version Python License: MIT

A self-contained, lightweight Google Maps Model Context Protocol (MCP) server built with the official MCP Python SDK. It provides AI agents (such as Claude Desktop, Cursor, Cline, and Antigravity) with structured search results, place details, ratings, contact info, coordinates, and Google Maps URLs.

⚡ Key Features

One-Command Installation: Runs anywhere instantly via uvx without manual environment setup.
100% Self-Contained: Scraper engine is integrated natively in-process via asyncio and aiohttp—no external subprocesses, headless browsers, or API keys required.
Rich Structured Place Data: Returns Place IDs, business names, categories, addresses, local & international phone numbers, website URLs, coordinates (lat/long), star ratings, review counts, and direct Google Maps links.
Stdio & Streamable HTTP: Native stdio support for desktop AI clients and streamable-http for remote/containerized deployments.
Clean JSON-RPC: All internal logging is piped strictly to stderr, keeping the stdio protocol stream 100% compliant.

Related MCP server: Google Maps MCP Server

🚀 Quickstart

Run directly using uvx:

# Run directly from GitHub repository
uvx --from git+https://github.com/<your-username>/gmaps-mcp.git gmaps-mcp

Or from a local clone:

uv run gmaps-mcp

🛠️ MCP Client Configuration

1. Claude Desktop

Add this to your claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "google-maps": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/<your-username>/gmaps-mcp.git",
        "gmaps-mcp"
      ]
    }
  }
}

If running from a local folder:

{
  "mcpServers": {
    "google-maps": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/gmap-mcp",
        "gmaps-mcp"
      ]
    }
  }
}

2. Cursor IDE

In Cursor, open Settings → Features → MCP (or edit .cursor/mcp.json in your project):

{
  "mcpServers": {
    "google-maps": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/<your-username>/gmaps-mcp.git",
        "gmaps-mcp"
      ]
    }
  }
}

3. Cline (VS Code Extension)

In Cline Settings (cline_mcp_settings.json):

{
  "mcpServers": {
    "google-maps": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/<your-username>/gmaps-mcp.git",
        "gmaps-mcp"
      ]
    }
  }
}

🧰 Available Tools

1. `search_google_maps`

Search Google Maps for businesses, attractions, services, and landmarks.

Parameter	Type	Default	Description
`query`	`string`	(required)	Search term (e.g. `"coffee in Koramangala Bangalore"`, `"dentists near Connaught Place Delhi"`, `"Italian restaurants in New York"`).
`limit`	`integer`	`10`	Maximum number of results to return (`1` to `50`).
`country`	`string`	`"in"`	Two-letter ISO country code for region localization (e.g. `"in"`, `"us"`, `"gb"`, `"de"`, `"fr"`, `"ae"`).
`language`	`string`	`"en"`	Language code for results (e.g. `"en"`, `"hi"`, `"es"`, `"fr"`).

Output Structure

{
  "query": "coffee in Koramangala Bangalore",
  "country": "in",
  "language": "en",
  "total_results": 2,
  "places": [
    {
      "place_id": "ChIJ80IECk8UrjsRqCffDjE09lw",
      "name": "Dyu Art Cafe",
      "category": "Art cafe",
      "address": "KHB MIG Colony, 1st Cross Rd, Koramangala 8th Block, Bengaluru, Karnataka 560095",
      "phone": "096113 19774",
      "international_phone": "+91 96113 19774",
      "website": "http://www.dyuartcafe.com/",
      "domain": "dyuartcafe.com",
      "latitude": 12.9373076,
      "longitude": 77.6176544,
      "rating": 4.4,
      "review_count": 21440,
      "google_maps_url": "https://www.google.com/maps/place/?q=place_id:ChIJ80IECk8UrjsRqCffDjE09lw"
    }
  ]
}

2. `get_place_details`

Retrieve detailed information for a single specific place or business by its Place ID or name.

Parameter	Type	Default	Description
`place`	`string`	(required)	Google Place ID (e.g. `"ChIJ12k5kG_iDDkRwuzibQwYZ4M"`) or exact business/landmark name (e.g. `"AIIMS New Delhi"`).
`country`	`string`	`"in"`	Two-letter ISO country code (default: `"in"`).
`language`	`string`	`"en"`	Language code for response (default: `"en"`).

🌐 Remote Deployment (Streamable HTTP)

The server supports modern Streamable HTTP transport for deployment behind reverse proxies or cloud hosting:

# Start Streamable HTTP server on port 8000
uv run gmaps-mcp --transport streamable-http --host 0.0.0.0 --port 8000

The MCP endpoint will be available at: http://<host>:8000/mcp

🧪 Development & Testing

Run unit and integration tests using uv:

# Run pytest test suite
uv run --with pytest --with pytest-asyncio pytest tests/ -v

# Run the server locally with debug logs
uv run gmaps-mcp --log-level DEBUG

📦 Project Structure

gmap-mcp/
├── pyproject.toml              # Packaging & dependencies (PEP 517/621)
├── README.md                   # Setup guide and MCP client docs
├── src/
│   └── gmaps_mcp/
│       ├── __init__.py         # Package entry
│       ├── schemas.py          # Pydantic data models (Place, Search, Details)
│       ├── server.py           # MCPServer instance & CLI runner
│       ├── tools.py            # MCP Tool definitions & detailed descriptions
│       └── scraper/
│           ├── __init__.py     # Scraper API
│           └── crawler.py      # Async Google Maps parser & extraction engine
└── tests/
    ├── test_schemas.py         # Schema tests
    ├── test_crawler.py         # Parser unit tests
    └── test_server.py          # MCP Server registration & tool calling tests

📜 Attribution & License

Scraper core adapted and modularized from christivn/mapScraper (commit 1b38cf3e153294e3dad2f6cb5862be0201a54065).
Licensed under the MIT License.

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

Google Maps MCP Server
Location Services Search
iceener
F
license
-
quality
C
maintenance
Enables location-aware AI agents to search for nearby places, get detailed place information including hours and ratings, and calculate routes with turn-by-turn directions using Google Maps APIs.
Updated 23 days ago (2026-07-27 13:22 UTC)
21
Google Maps MCP Server
Location Services Search Travel & Transportation
arthurkatcher
A
license
A
quality
B
maintenance
Enables AI assistants to access Google Maps services including places search, details, directions, geocoding, and nearby search through natural language.
Updated 3 months ago (2026-05-04 08:04 UTC)
6
2
MIT
maps-scrapper
Web Scraping Browser Automation Location Services
rahul-bhatt43
F
license
-
quality
C
maintenance
Enables AI assistants to search and scrape Google Maps places data (name, rating, address, etc.) directly without an API key.
Updated 9 days ago (2026-08-10 05:14 UTC)
gmapsscraper
Web Scraping Location Services Search
gmapsscraper
A
license
A
quality
B
maintenance
Enables AI assistants to scrape Google Maps business data (names, addresses, phones, emails, websites, ratings, etc.) through natural language queries, with tools for synchronous and asynchronous scraping and credit checking.
Updated 15 days ago (2026-08-04 04:55 UTC)
4
32
3
MIT

View all related MCP servers

Related MCP Connectors

Google Maps Scraper
Live Google Maps business search, review, and photo data for AI agents over MCP.
bizintel
Local business intel for AI agents: audits, lead scoring, tech stack, prospecting.
Parallel Search MCP
The best web search for your AI Agent

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/devsanthoshmk/gmaps-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

🗺️ Google Maps MCP Server (gmaps-mcp)