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

Contacts & CRM

listContacts

List Contacts

List the caller's personal contacts: the people layer of their CRM.

read

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "list my contacts", and it calls listContacts.

Example call

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

{
  "arguments": {},
  "name": "listContacts"
}

Arguments

• includeArchivedbooleanoptionalInclude archived contacts. Defaults to false (active only).
• limitintegeroptionalMax contacts to return (default 50, max 200).
• searchstringoptionalOptional free-text filter matched against name, email, phone, job title, and notes.
• tagsstring[]optionalOptional tags: a contact matches if it carries any of them.

Returns

Returns each contact's id, name, and core fields.

Declared limits

• limit: greater than 0
• limit: maximum 200

Ask for it

The Cloud routes these requests to this verb.

• list my contacts
• who do I have saved
• show contacts tagged investor
• find contacts at Acme

Pair it with

The verbs that finish the job.

• getContact
• searchContacts
• resolveContact
• createContact

Questions

• What does listContacts do?

  List the caller's personal contacts: the people layer of their CRM. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use listContacts 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 "list my contacts", and it calls listContacts.

• Is listContacts safe to let an AI call?

  listContacts 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.