1. Docs
2. /
3. Tool reference
4. /
5. Contacts & CRM
6. /
7. searchContacts

Contacts & CRM

searchContacts

Search Contacts

Search the caller's personal contacts by a single query string, matched across name, email, phone, job title, and notes.

read

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "search my contacts for Maria", and it calls searchContacts.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "query": "<query>"
  },
  "name": "searchContacts"
}

Arguments

• includeArchivedbooleanoptionalInclude archived contacts. Defaults to false (active only).
• limitintegeroptionalMax contacts to return (default 50, max 200).
• querystringrequiredThe text to search for across contact fields.

Returns

Returns matching contacts with their ids.

Declared limits

• limit: greater than 0
• limit: maximum 200
• query: minimum length 1

Ask for it

The Cloud routes these requests to this verb.

• search my contacts for Maria
• find the contact who works at Stripe
• look up anyone with a gmail address

Pair it with

The verbs that finish the job.

• listContacts
• getContact
• resolveContact

Questions

• What does searchContacts do?

  Search the caller's personal contacts by a single query string, matched across name, email, phone, job title, and notes. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use searchContacts from Claude or ChatGPT?

  Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "search my contacts for Maria", and it calls searchContacts.

• Is searchContacts safe to let an AI call?

  searchContacts is read-only: it changes nothing.

Connect

One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.