MCP Tools Reference: people.googleapis.com

Tool: search_contacts

Kontakte des Nutzers durchsuchen.

WICHTIGE REGELN:

  • Wenn dieses Tool mehrere Ergebnisse zurückgibt, sollten Sie dem Nutzer die Ergebnisse präsentieren und ihn um eine Klarstellung bitten, welches Ergebnis verwendet werden soll, bevor Sie fortfahren.

  • Es ist Ihnen strengstens untersagt, die Ausgabe dieses Tools ohne ausdrückliche Bestätigung des Nutzers an ein anderes Tool zu übergeben (z. B. eine E‑Mail zu senden, einen Entwurf zu erstellen oder ein Ereignis zu erstellen).

  • Auch wenn nur ein Ergebnis für eine Person gefunden wird, müssen Sie dem Nutzer die Details der gefundenen Person präsentieren und ihn auffordern, zu bestätigen, dass es sich um die gewünschte Person handelt, bevor Sie mit weiteren Schritten fortfahren.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool search_contacts aufrufen.

Curl-Anfrage 
curl --location 'https://people.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_contacts",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

Anfragenachricht für SearchContacts

SearchContactsMcpRequest

JSON-Darstellung 
{
  "query": string,
  "maxResults": integer
}
Felder
query

string

Abfragestring für die Suche.
maxResults

integer

Maximale Anzahl der Ergebnisse. Der Standardwert ist 10 und der maximal zulässige Wert ist 30.

Ausgabeschema

Antwortnachricht für SearchContacts.

SearchContactsMcpResponse

JSON-Darstellung 
{
  "results": [
    {
      object (SearchContactsResult)
    }
  ]
}
Felder
results[]

object (SearchContactsResult)

Die Liste der Kontakte, die der Anfrage entsprechen.

SearchContactsResult

JSON-Darstellung 
{
  "name": string,
  "email": string
}
Felder
name

string

Der Anzeigename des Kontakts.
email

string

Die E-Mail-Adresse des Kontos des Kontakts.

Tool-Annotationen

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/contacts.readonly