How to Use the Google Maps MCP in Windsurf

Q: How do I add the Google Maps MCP Server to Windsurf?

You open your mcpconfig.json file in Windsurf and register this MCP Server configuration under the mcpServers key. After clicking refresh in your MCP panel, Cascade immediately gains access to all four spatial tools.

Q: Does Windsurf support batch routing with this tool?

The agent handles batch routing by executing directions in a loop for each destination. Cascade plans this sequence autonomously, gathering ETAs for twenty delivery stops and writing them to your config files in one run.

Watch Windsurf Cascade autonomously chain geocoding, route calculations, and venue searches right in your workspace.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Google Maps MCP to Windsurf

Create your Vinkius account to connect Google Maps to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Google Maps with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated route planning in Windsurf

This MCP server exposes `directions` to calculate the optimal path and travel times between any two points without you writing boilerplate code. Windsurf Cascade triggers this tool when you ask it to plan logistics, instantly getting the exact mileage and ETA. Look, you don't have to copy-paste coordinates from a browser tab anymore. Cascade runs the tool, reads the output, and writes the configuration files for your delivery app in one continuous run.

Bulk address geocoding without manual scripts

`geocode` converts raw address strings into exact latitude and longitude coordinates. When Cascade spots a list of unformatted shipping destinations in your project, it calls this tool to clean up the data. The agent handles the API payload formatting behind the scenes. It takes the returned coordinates and immediately updates your local database files.

Deep venue lookups for local service directories

`place_search` finds target businesses in any city, and `place_details` grabs their operational hours, phone numbers, and websites. Windsurf uses these two tools in tandem to scrape and structure local business data. Cascade runs the search query, grabs the unique IDs, and feeds them into the detail lookup tool using this MCP integration. You get a fully populated JSON database of local spots in seconds without writing a single scraper.

Setup guide

Set up Google Maps MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Google Maps MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Google Maps payment history." If connected, Cascade will call the Google Maps tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "google-maps-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Google Maps. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Google Maps now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Google Maps MCP in Windsurf

Cascade calls the Google Maps tools directly when your prompt requires location data. It reads your active files, detects address strings, and executes `geocode` or `directions` to update your code without needing manual confirmation.

Yes, you can generate map components easily. Cascade uses the coordinates returned by `geocode` to populate your React or Leaflet map configurations instantly, writing the exact latitude and longitude directly into your source files.

You open your `mcp_config.json` file in Windsurf and register this MCP Server configuration under the `mcpServers` key. After clicking refresh in your MCP panel, Cascade immediately gains access to all four spatial tools.

The agent handles batch routing by executing `directions` in a loop for each destination. Cascade plans this sequence autonomously, gathering ETAs for twenty delivery stops and writing them to your config files in one run.

Your address queries, latitude data, and location lookups go directly to the Google API through our secure MCP gateway. We never store your proprietary geographic data or route histories on Vinkius servers.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript