List contacts

Contacts from a Freshsales view such as Never Contacted.

MCP tool freshsales_read → list_contacts

read

Lists contacts as the Contacts module shows them for that view, with name, email, account, owner and the date they were last contacted. last_contacted is empty for a contact nobody has talked to. Read a page at a time with next_cursor.

Parameters

Parameters: list_contacts
NameTypeDescription
view string string My Contacts, All Contacts, Recently Modified or Never Contacted. Default My Contacts.
sort string string created_at, updated_at or last_contacted.
sort_type string string asc or desc. Default desc.
cursor string string next_cursor of the previous page.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "freshsales_read",
    "arguments": {
      "operation": "list_contacts",
      "arguments": {}
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "contacts": [
      {
        "contact_id": 5100231,
        "name": "Priya Nair",
        "email": "priya@harbordental.example",
        "account": "Harbor Dental",
        "owner": "Dana Reyes",
        "last_contacted": "2026-10-02"
      },
      {
        "contact_id": 5100244,
        "name": "Tomas Weber",
        "email": "tomas@northwind.example",
        "account": "Northwind Studio",
        "owner": "Dana Reyes",
        "last_contacted": null
      }
    ],
    "next_cursor": null
  },
  "isError": false
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.