List contact lists

List your Findymail contact lists with their IDs.

MCP tool findymail_read → list_contact_lists

read

Returns every list with its ID, name, dates, whether it is shared with the team and whether you own it. Use the ID in list_contacts. Reading lists is free.

Parameters

No parameters.

tools/call

JSON-RPC

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

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "lists": [
      {
        "id": 3108,
        "name": "Q4 outreach",
        "created_at": "2026-09-30T08:12:00Z",
        "updated_at": "2026-10-21T14:03:00Z",
        "shared_with_team": false,
        "is_owner": true
      },
      {
        "id": 2975,
        "name": "Webinar leads",
        "created_at": "2026-08-12T10:40:00Z",
        "updated_at": "2026-09-02T09:15:00Z",
        "shared_with_team": true,
        "is_owner": true
      }
    ]
  },
  "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.