Docs
MCP clients

Google Gemini and Search

Connect Servicebay to the Gemini app and Google Search, see what Gemini can read, disconnect, and delete your data

You can connect Servicebay to the Google Gemini app and Google Search through Google's Connected Apps platform. Then you can ask things like "what's the status of job 1042?" and get answers from your Servicebay data. The connection is read-only: Gemini can look things up, but it can't change anything in Servicebay.

Not seeing Servicebay in Gemini?

Google rolls connected apps out gradually. If Servicebay isn't offered in your Gemini app or Google Search yet, it isn't available for your Google account.

Before you start

  • You need to be an admin of a Servicebay organisation on Pro or a trial.
  • Your Servicebay sign-in needs two-factor authentication with an authenticator app. You'll be asked for a code when you approve the connection. See Two-Factor Authentication.

Connect Servicebay

  1. In the Gemini app or Google Search, choose Servicebay from the apps Google offers to connect. Google opens the Servicebay sign-in page.
  2. Sign in with your Servicebay email and password, then enter your authenticator code.
  3. Under Connect to organisation, choose the organisation Gemini should read.
  4. Leave all permissions ticked and the expiry set to No expiry. Any other expiry ends the connection on that date.
  5. Select Allow access. You return to Google.

What Gemini can see

Gemini can read:

  • Customers: name, business name, email, phone numbers, address, notes and preferred contact method
  • Jobs: job number, status, customer contact details, device, service requested, notes, address, schedule and warranty details
  • Job statuses: your organisation's status list
  • Appointments: time, technician, location and notes
  • Quotes and invoices: numbers, line items, amounts, dates, and whether they're accepted or paid

Gemini can't create, change or delete anything. It also can't see payment card details, passwords, your team members or your organisation settings.

How Gemini names your records

Ask about records the way your team talks about them: a job, quote or invoice by its number, a customer by name, business name, email or phone.

In the version Gemini uses today, Servicebay's answers also carry its internal database IDs for customers, invoices, quotes and appointments, which Gemini uses to look a record up again. You never need to know or type one.

A new version of the connection is in Google's review. It gives Gemini no internal IDs and looks every record up by its number, name, email or phone. When a name fits more than one record (two customers called John Smith, say), Gemini asks you which one you mean, showing what tells them apart, such as their phone number or city. Gemini switches to it once Google approves it, and you don't need to do anything.

Servicebay only sends what Gemini asks for to answer your question, and it never receives your conversation. Anyone signed in to Gemini with the connected Google account can ask about the organisation you connected, so connect only a Google account you control.

See what's connected

Organisation admins can see every app connected to the organisation:

  1. Sign in at developer.servicebay.io and open Connected Apps.
  2. Each connection shows the app, who connected it and its permissions. Select Activity to see recent requests it made.

Disconnect

You can disconnect from either side:

  • From Google: open your Google Account connections and remove Servicebay. The connection stops working straight away.
  • From Servicebay: an organisation admin can open Connected Apps, find the Google connection and select Revoke.

A connection also ends on its own if the admin who made it is removed from the organisation or deactivated. A Google connection stops working after 30 days without use. To use Gemini with Servicebay again, connect again.

Delete your data

  • The connection: disconnecting deletes the connection, its access tokens and any permission changes made to it in Connected Apps. A connection that stops working on its own (after 30 days without use, or when its expiry date passes) is deleted automatically within about two days. Requests in your organisation's activity log are deleted automatically after 90 days. To have any other connection records deleted, email support@servicebay.io.
  • Your Servicebay data: your customers, jobs, quotes and invoices stay in Servicebay when you disconnect. Delete individual records in the Servicebay app. To delete your whole account, go to Settings → Privacy & Data → Delete Account in the app, or email support@servicebay.io.
  • What Gemini already showed you: Google stores your Gemini conversations, not Servicebay. To review or delete them, go to Gemini Apps Activity. For more, see the Gemini Apps Privacy Hub.

For the full details, read the Servicebay Privacy Policy. For questions, email support@servicebay.io.

For developers

Google calls a dedicated, read-only MCP endpoint, https://oauth.servicebay.io/mcp/google/v1, with its own protected resource metadata. It offers only the six :read scopes for customers, jobs, job statuses, calendar, quotes and invoices. Other MCP clients use https://oauth.servicebay.io/mcp; see the compatibility matrix.

Google records each version's tool list when it publishes the app, so each version has its own path:

EndpointStatusIDs
/mcp/google/v1Live: what Gemini and Google Search call today. Frozen; retires once Google publishes v2Returns and takes database IDs (customer_id, invoice_id, quote_id, appointment_id)
/mcp/google/v2In Google's review. It already answers, with its own protected resource metadata, for testing in Gemini Developer Mode. The same ten read-only tools as v1, under the same namesNone in results or inputs. Records are named by number, name, email or phone. A record a tool can take back carries an opaque ref. Several matches return needsChoice with the choices. Every tool declares an output schema, and results are JSON in the text. Failures the model can't fix (connection, permission, rate limit, outage) are JSON-RPC errors with Google's codes (-32302, -32300, -32502, -32500)