# Google Business Profile

Source: https://pilot.braike.com/en/docs/regies/google-business

The 10 tools Pilot MCP serves for Google Business Profile: 5 read-only, and 5 that write with the €29 plan, taken from the server.

Pilot MCP serves **5 read-only tools** for Google Business Profile, on every plan. With the €29 plan, it also serves **5** that create or change. Their names start with `google_business_`.

<Callout title="What each entry shows">
The name, description and parameters come from the list the server serves to your assistant (`tools/list`). Descriptions are in English: this is the text your assistant receives. Your assistant never fills in platform credentials: Pilot adds them on each call.
</Callout>

<Callout title="Writing and deleting">
Write tools are only served with the €29 plan: your assistant creates, changes, pauses and deletes there, with no access level to pick when you connect. On the free plan, it does not see them. A change that sets an object to deleted or archived counts as a deletion, and a deletion targets one object at a time. Changes apply directly on the ad platform: Pilot reads the object from the platform before and after the write, and logs it in your workspace. See [Read and write](/en/docs/limites-et-forfaits#ecritures).
</Callout>

## Tool families [#familles]

| Family | Tools |
| --- | ---: |
| [Other tools](#autres) | 5 |
| [Create and change (€29)](#modification) | 5 |

## Other tools [#autres]

### `google_business_get_business_location` [#google_business_get_business_location]

**Google Business Profile: Get Business Location** · read-only · idempotent

Full details of one Google Business Profile business listing, by its resource name.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `location_name` | `string` | yes | Resource name, in the form "locations/123". |

### `google_business_get_business_performance` [#google_business_get_business_performance]

**Google Business Profile: Get Business Performance** · read-only · idempotent

Daily metrics of a listing: views on Search and Maps, calls, website clicks, direction requests, bookings.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `location_name` | `string` | yes | Resource name, in the form "locations/123". |
| `start_date` | `string` | yes | Start date, YYYY-MM-DD. |
| `end_date` | `string` | yes | End date, YYYY-MM-DD. |
| `metrics` | `string[]` | no | Metrics wanted. Default: all 11. Values: `"BUSINESS_IMPRESSIONS_DESKTOP_MAPS"`, `"BUSINESS_IMPRESSIONS_DESKTOP_SEARCH"`, `"BUSINESS_IMPRESSIONS_MOBILE_MAPS"`, `"BUSINESS_IMPRESSIONS_MOBILE_SEARCH"`, `"BUSINESS_CONVERSATIONS"`, `"BUSINESS_DIRECTION_REQUESTS"`, `"CALL_CLICKS"`, `"WEBSITE_CLICKS"`, `"BUSINESS_BOOKINGS"`, `"BUSINESS_FOOD_ORDERS"`, `"BUSINESS_FOOD_MENU_CLICKS"`. |

### `google_business_get_business_search_keywords` [#google_business_get_business_search_keywords]

**Google Business Profile: Get Business Search Keywords** · read-only · idempotent

Keywords through which customers found the listing on Google (monthly volumes, rounded by Google).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `location_name` | `string` | yes | Resource name, in the form "locations/123". |
| `start_month` | `string` | yes | Start month, YYYY-MM. |
| `end_month` | `string` | yes | End month, YYYY-MM. |

### `google_business_list_business_accounts` [#google_business_list_business_accounts]

**Google Business Profile: List Business Accounts** · read-only · idempotent

Lists the accessible Google Business Profile accounts. Entry point: the listings are then listed per account.

No parameters.

### `google_business_list_business_locations` [#google_business_list_business_locations]

**Google Business Profile: List Business Locations** · read-only · idempotent

Lists the business listings of an account (name, address, phone, category, hours, Maps link).

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `account_name` | `string` | yes | Resource name of the account, in the form "accounts/123" (see list\_business\_accounts). |

## Create and change (€29) [#modification]

Served with the €29 plan.

### `google_business_update_business_description` [#google_business_update_business_description]

**Google Business Profile: Update Business Description** · create or change, €29 plan · creates an object on each call

Replaces the description of a linked Google Business Profile listing, written in the name of the business. Without confirm: true, nothing changes.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `location_name` | `string` | yes | Resource name of the listing, in the form "locations/123" (returned by list\_business\_locations). |
| `description` | `string` | yes |   |
| `confirm` | `boolean` | no | True to write. Without it, Google validates the change without applying it, and nothing changes on the listing. |

### `google_business_update_business_phones` [#google_business_update_business_phones]

**Google Business Profile: Update Business Phones** · create or change, €29 plan · creates an object on each call

Changes the phone numbers of a linked Google Business Profile listing: the primary one and up to two others, which Google requires together ("both fields must be set"). International format recommended (+33 1 23 45 67 89). Without confirm: true, nothing changes.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `location_name` | `string` | yes | Resource name of the listing, in the form "locations/123" (returned by list\_business\_locations). |
| `primary_phone` | `string` | yes |   |
| `additional_phones` | `string[]` | no | At most two; an empty list removes them. |
| `confirm` | `boolean` | no | True to write. Without it, Google validates the change without applying it, and nothing changes on the listing. |

### `google_business_update_business_regular_hours` [#google_business_update_business_regular_hours]

**Google Business Profile: Update Business Regular Hours** · create or change, €29 plan · creates an object on each call

Replaces the regular hours of a linked Google Business Profile listing: one period per opening slot, times HH:MM from 00:00 to 24:00, closing after opening. Without confirm: true, nothing changes.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `location_name` | `string` | yes | Resource name of the listing, in the form "locations/123" (returned by list\_business\_locations). |
| `periods` | `object[]` | yes |   |
| `confirm` | `boolean` | no | True to write. Without it, Google validates the change without applying it, and nothing changes on the listing. |

### `google_business_update_business_special_hours` [#google_business_update_business_special_hours]

**Google Business Profile: Update Business Special Hours** · create or change, €29 plan · creates an object on each call

Replaces the special hours of a linked Google Business Profile listing (public holidays, closures): each period lasts less than 24 hours, on one day or spanning into the next day. Requires regular hours. Without confirm: true, nothing changes.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `location_name` | `string` | yes | Resource name of the listing, in the form "locations/123" (returned by list\_business\_locations). |
| `periods` | `object[]` | yes |   |
| `confirm` | `boolean` | no | True to write. Without it, Google validates the change without applying it, and nothing changes on the listing. |

### `google_business_update_business_website` [#google_business_update_business_website]

**Google Business Profile: Update Business Website** · create or change, €29 plan · creates an object on each call

Changes the website of a linked Google Business Profile listing. The listing is public: without confirm: true, Google validates without applying and nothing changes. Reads the listing before and after.

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `location_name` | `string` | yes | Resource name of the listing, in the form "locations/123" (returned by list\_business\_locations). |
| `website_uri` | `string` | yes |   |
| `confirm` | `boolean` | no | True to write. Without it, Google validates the change without applying it, and nothing changes on the listing. |
