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

Contacts & CRM

importContacts

Import Contacts

Import contacts either from supplied rows or from a TripleSeat contacts export in Cloud Files (a contacts export, the Accounts Report or the Accounts and Contacts Report).

write

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "import these contacts", and it calls importContacts.

Example call

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

{
  "arguments": {},
  "name": "importContacts"
}

Arguments

• batchIdstringoptionalRows path: append to this existing import batch instead of opening a new one.
• categoryobjectoptionalRows path, required with `rows`: what this import is, so the contacts are filed as the people they are.
• dryRunbooleanoptionalTripleSeat path: true (the default) reports what would land without writing anything. Pass false only once the owner has read the report and wants the address book committed.
• fileIdstringoptionalTripleSeat path: the Cloud Files id of the TripleSeat contacts export. Present means the TripleSeat path; omit it to import `rows`.
• folderIdstringoptionalTripleSeat path: the manual contact folder the imported people land in.
• previewIdstringoptionalRows path: the single-use id returned by previewContactImport.
• previewPageintegeroptionalTripleSeat path: which page of the preview to list, from 1. Every group lists its rows a page at a time and counts the rest, so a long book is read in full across pages.
• rowsobject[]optionalRows path: the people to import (max 200 per call).
• sourcestringoptionalWhere the contacts came from.
• sourceAccountstringoptionalRows path: the account the rows were read from.
• teamIdstringoptionalTripleSeat path: the team whose shop receives the import.

Returns

With fileId, the TripleSeat path defaults to a dry run: it matches each row by normalized email, then normalized phone, then exact name plus company, and returns a preview of the new, updated and…

Declared limits

• previewPage: minimum 1
• previewPage: maximum 9007199254740991
• rows: maximum items 200

Ask for it

The Cloud routes these requests to this verb.

• import these contacts
• add these people as friends
• import my address book
• bring our TripleSeat contacts across
• import the TripleSeat accounts

Pair it with

The verbs that finish the job.

• previewContactImport
• undoContactImport
• restageContactImport
• listContactImports
• listContactFolders
• findDuplicateClients

Questions

• What does importContacts do?

  Import contacts either from supplied rows or from a TripleSeat contacts export in Cloud Files (a contacts export, the Accounts Report or the Accounts and Contacts Report). It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use importContacts 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 "import these contacts", and it calls importContacts.

• Is importContacts safe to let an AI call?

  importContacts changes your workspace. What an AI creates is Private until you share it.

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.