docs: google maps tutorial (#1353)

documentation/docs/getting-started/using-extensions.md

@@ -319,7 +319,7 @@ goose session --with-extension "GITHUB_PERSONAL_ACCESS_TOKEN=<YOUR_TOKEN> npx -y
 ```
 
 :::info
-Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses npx.
+Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses `npx`.
 :::
 
 

documentation/docs/troubleshooting.md

@@ -171,7 +171,7 @@ Please check extension configuration for {extension name}.
 
 ... it signals that the extension may not have been installed and you need the package runner in order to do so.
 
-An example is the GitHub extension whose command is `npx -y @modelcontextprotocol/server-github`. You'd need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses npx.
+An example is the GitHub extension whose command is `npx -y @modelcontextprotocol/server-github`. You'd need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses `npx`.
 
 ---
 

documentation/docs/tutorials/_template_.md

@@ -28,6 +28,14 @@ This tutorial covers how to add the [{name} MCP Server](/) as a Goose extension
 
 ## Configuration
 
+:::info
+Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses `npx`.
+:::
+
+:::info
+Note that you'll need [uv](https://docs.astral.sh/uv/#installation) installed on your system to run this command, as it uses `uvx`.
+:::
+
 <Tabs groupId="interface">
   <TabItem value="cli" label="Goose CLI" default>
   1. Run the `configure` command:
@@ -103,10 +111,10 @@ This tutorial covers how to add the [{name} MCP Server](/) as a Goose extension
     │  Command-line Extension 
     │
     ◇  What would you like to call this extension?
-    │  {name}}
+    │  {name}
     │
     ◇  What command should be run?
-    │  {command}}
+    │  {command}
     // highlight-start
     ◆  Would you like to add environment variables?
     │  Yes 

documentation/docs/tutorials/fetch-mcp.md

@@ -24,13 +24,13 @@ uvx mcp-server-fetch
 ```
 :::
 
+
+## Configuration
+
 :::info
 Note that you'll need [uv](https://docs.astral.sh/uv/#installation) installed on your system to run this command, as it uses `uvx`.
 :::
 
-
-## Configuration
-
 <Tabs groupId="interface">
   <TabItem value="cli" label="Goose CLI" default>
   1. Run the `configure` command:

documentation/docs/tutorials/figma-mcp.md

@@ -26,12 +26,12 @@ FIGMA_ACCESS_TOKEN: <YOUR_TOKEN>
 ```
 :::
 
+## Configuration
+
 :::info
-Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses npx.
+Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses `npx`.
 :::
 
-## Configuration
-
 <Tabs groupId="interface">
   <TabItem value="cli" label="Goose CLI" default>
   1. Run the `configure` command:

documentation/docs/tutorials/github-mcp.md

@@ -24,12 +24,13 @@ GITHUB_PERSONAL_ACCESS_TOKEN: <YOUR_TOKEN>
 ```
 :::
 
-:::info
-Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses npx.
-:::
 
 ## Configuration
 
+:::info
+Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses `npx`.
+:::
+
 <Tabs groupId="interface">
   <TabItem value="cli" label="Goose CLI" default>
   1. Run the `configure` command:

documentation/docs/tutorials/google-drive-mcp.md

@@ -38,6 +38,10 @@ GDRIVE_OAUTH_PATH: ~/.config/gcp-oauth.keys.json
 
 ## Configuration
 
+:::info
+Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses `npx`.
+:::
+
 To obtain your Google Drive server credentials and oauth keys, follow the steps below:
 
   1. Set up your Google Cloud Credentials, to enable API access:

documentation/docs/tutorials/google-maps-mcp.md

@@ -0,0 +1,268 @@
+---
+title: Google Maps Extension
+description: Add Google Maps MCP Server as a Goose Extension
+---
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
+
+
+This tutorial covers how to add the [Google Maps MCP Server](https://github.com/modelcontextprotocol/servers/tree/main/src/google-maps) as a Goose extension to enable geocoding, place searching, distance calculations, elevation data retrieval, and directions.
+
+
+:::tip TLDR
+
+**Command**
+```sh
+npx -y @modelcontextprotocol/server-google-maps
+```
+
+**Environment Variable**
+```
+GOOGLE_MAPS_API_KEY: <YOUR_TOKEN>
+```
+:::
+
+## Configuration
+
+:::info
+Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses `npx`.
+:::
+
+<Tabs groupId="interface">
+  <TabItem value="cli" label="Goose CLI" default>
+  1. Run the `configure` command:
+  ```sh
+  goose configure
+  ```
+
+  2. Choose to add a `Command-line Extension`
+  ```sh
+    ┌   goose-configure 
+    │
+    ◇  What would you like to configure?
+    │  Add Extension 
+    │
+    ◆  What type of extension would you like to add?
+    │  ○ Built-in Extension 
+    // highlight-start    
+    │  ● Command-line Extension (Run a local command or script)
+    // highlight-end    
+    │  ○ Remote Extension 
+    └ 
+  ```
+
+  3. Give your extension a name
+  ```sh
+    ┌   goose-configure 
+    │
+    ◇  What would you like to configure?
+    │  Add Extension 
+    │
+    ◇  What type of extension would you like to add?
+    │  Command-line Extension 
+    │
+    // highlight-start
+    ◆  What would you like to call this extension?
+    │  Google Maps
+    // highlight-end
+    └ 
+  ```
+
+  4. Enter the command
+  ```sh
+    ┌   goose-configure 
+    │
+    ◇  What would you like to configure?
+    │  Add Extension 
+    │
+    ◇  What type of extension would you like to add?
+    │  Command-line Extension 
+    │
+    ◇  What would you like to call this extension?
+    │  Google Maps
+    │
+    // highlight-start
+    ◆  What command should be run?
+    │  npx -y @modelcontextprotocol/server-google-maps
+    // highlight-end
+    └ 
+  ```  
+
+  5. Obtain a [Google Maps API Key](https://developers.google.com/maps/documentation/javascript/get-api-key) and paste it in.
+
+   ```sh
+    ┌   goose-configure 
+    │
+    ◇  What would you like to configure?
+    │  Add Extension 
+    │
+    ◇  What type of extension would you like to add?
+    │  Command-line Extension 
+    │
+    ◇  What would you like to call this extension?
+    │  Google Maps
+    │
+    ◇  What command should be run?
+    │  npx -y @modelcontextprotocol/server-google-maps
+    // highlight-start
+    ◆  Would you like to add environment variables?
+    │  Yes 
+    │
+    ◇  Environment variable name:
+    │  GOOGLE_MAPS_API_KEY
+    │
+    ◇  Environment variable value:
+    │  ▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪▪
+    │
+    ◇  Add another environment variable?
+    │  No 
+    // highlight-end
+    └  Added github extension
+  ```  
+
+  </TabItem>
+  <TabItem value="ui" label="Goose Desktop">
+  1. Click `...` in the upper right corner
+  2. Click `Settings`
+  3. Under `Extensions`, click the `Add` link
+  4. On the `Add Extension Manually` modal, enter the following:
+        * **Type**: `Standard IO`
+        * **ID**: `google-maps-mcp` (_set this to whatever you want_)
+        * **Name**: `Google Maps` (_set this to whatever you want_)
+        * **Description**: `Google Maps API` (_set this to whatever you want_)
+        * **Command**: `npx -y @modelcontextprotocol/server-google-maps`
+        * **Environment Variables**
+            * **Name**: `GOOGLE_MAPS_API_KEY`
+            * **Value**: (_Obtain a [GOOGLE_MAPS_API_KEY](https://developers.google.com/maps/documentation/javascript/get-api-key) and paste it in._)
+            * Click `Add` button
+  5. Click `Add Extension` button
+  </TabItem>
+</Tabs>
+
+## Example Usage
+
+Goose acts as an autonomous agent that tracks a delivery driver’s location, updates the customer in real-time, and adjusts ETAs dynamically based on Google Maps traffic data.
+
+Goose can:
+
+**Monitor Driver Location**
+* Goose gets the driver’s GPS coordinates every few seconds.
+* If the driver’s location is significantly behind schedule, Goose recalculates the ETA.
+
+**Traffic-Aware ETA Adjustments**
+* Goose queries Google Maps for live traffic conditions.
+* If delays are detected, Goose updates the customer’s tracker with a new estimated time.
+
+**Dynamic Customer Notifications**
+* If the driver is stuck in traffic, Goose sends an alert to the customer: “Your driver is running late due to traffic. Updated ETA: 7:25 PM.”
+* If the driver is ahead of schedule, Goose notifies the restaurant to prepare the food earlier.
+
+
+### Goose Prompt
+```
+Track the live GPS location of driver ID #12345. Query Google Maps for real-time traffic data and adjust the estimated delivery time if delays exceed 5 minutes. If ETA changes, update the customer’s live tracker and send an SMS notification. If the delay is greater than 20 minutes, check if another driver within a 1-mile radius can take over the delivery.
+```
+
+### Goose Output
+
+:::note CLI
+Okay, I will track Driver #12345, query Google Maps for traffic data, adjust the ETA, and notify the customer.
+
+**Track Driver's GPS Location**
+
+*   **Driver ID:** #12345
+*   **Starting Point:** 1955 Broadway, Suite 600, Oakland, CA 94612
+
+Driver #12345's movement:
+
+```
+2025-02-23 08:20:00: Latitude: 37.8074, Longitude: -122.2697 (Starting point)
+2025-02-23 08:21:00: Latitude: 37.8080, Longitude: -122.2690
+2025-02-23 08:22:00: Latitude: 37.8090, Longitude: -122.2680
+2025-02-23 08:23:00: Latitude: 37.8100, Longitude: -122.2670
+```
+
+
+**Geocode Destination Address**
+
+*   **Customer Address:** 2111 Mission Street, San Francisco, CA
+
+I will convert this address into geographic coordinates:
+
+
+`─── maps_geocode | googlemaps ──────────────────────────`
+
+address: 2111 Mission Street, San Francisco, CA
+
+```
+Latitude: 37.7631446
+Longitude: -122.4192073
+```
+
+
+**Get Initial Directions and ETA**
+
+I will get the initial route and ETA from the driver's starting point to the customer's address.
+
+
+`─── maps_directions | googlemaps ──────────────────────────`
+
+destination: 2111 Mission St, San Francisco, CA
+mode: driving
+origin: ...
+
+```
+Distance: 12.1 miles
+Initial ETA: 21 minutes
+Estimated arrival at: 08:41 AM
+```
+
+
+**Monitor Traffic and Adjust ETA**
+
+I will monitor traffic updates and recalculate the ETA periodically.
+
+```
+Remaining Distance: 8 miles
+Updated ETA: 15 minutes
+Estimated arrival at: 08:45 AM
+```
+
+There is no significant delay.
+
+*At 08:35 AM:* There's a traffic incident. 
+
+
+`─── maps_directions | googlemaps ──────────────────────────`
+
+destination: 2111 Mission St, San Francisco, CA
+mode: driving
+origin: Latitude: 37.8100, Longitude: -122.2670
+
+
+I apologize, I am unable to use the lat/long for the request. I will call google maps api with names instead.
+
+`─── maps_directions | googlemaps ──────────────────────────`
+
+destination: 2111 Mission St, San Francisco, CA
+mode: driving
+origin: ...
+
+```
+Remaining Distance: 7 miles
+Updated ETA: 26 minutes
+Estimated arrival at: 08:46 AM
+```
+
+
+The ETA has increased by 5 minutes from the original ETA of 08:41 AM. The directions now include a message: "Expect delays due to congestion."
+
+**Update Customer and Send SMS**
+
+[... other extensions used (e.g. Webhooks, MySQL, ClickSend)...]
+
+*   **Update Live Tracker:** The customer's live tracking interface is updated to reflect the new ETA of 08:46 AM.
+*   **Send SMS Notification:** _"Your delivery is now expected to arrive at approximately 08:46 AM due to traffic. We apologize for the inconvenience."_
+:::

documentation/docs/tutorials/knowledge-graph-mcp.md

@@ -20,12 +20,12 @@ npx -y @modelcontextprotocol/server-memory
 ```
 :::
 
+## Configuration
+
 :::info
-Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses npx.
+Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses `npx`.
 :::
 
-## Configuration
-
 <Tabs groupId="interface">
   <TabItem value="cli" label="Goose CLI" default>
   1. Run the `configure` command: