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 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 einen Termin zu erstellen).

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

Das folgende Beispiel zeigt, wie Sie curl verwenden, um das MCP-Tool search_contacts aufzurufen.

Curl-Anfrage 
curl --location 'https://people.googleapis.com/mcp/v1' \
--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

Suchstring.
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 Abfrage 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-Anmerkungen

Destruktiv: ❌ | Idempotent: ✅ | Schreibgeschützt: ✅ | Offene Welt: ❌