SalesTouch Docs
All MCP tools
Read onlyLinkedIn

LinkedIn conversations

linkedin_conversations_list

List recent LinkedIn messaging conversations from connected accounts.

When to use it

Read the most recent LinkedIn conversations or filter unread threads.

Required scopes
linkedin:accesssalestouch:use
Execution
Synchronous MCP tool call

Requirements

account_id is optional when SalesTouch can resolve a connected account automatically.

Example

Ask your agent

List my 20 most recent unread LinkedIn conversations and include participants.

Tool arguments
{
  "limit": 20,
  "unread": true,
  "include_participants": true
}
MCP response envelope
{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"data\": { ... },\n  \"meta\": null\n}"
    }
  ],
  "isError": false
}

Expected: A paginated list of normalized conversation summaries.

Parameters

account_id
string

Connected LinkedIn account id, remote id, username, email, handle, or account URL.

cursor
string

Pagination cursor.

before
string

ISO 8601 UTC datetime upper bound.

after
string

ISO 8601 UTC datetime lower bound.

limit
number

Maximum conversations to return. Defaults to 25, max 100.

unread
boolean

Filter unread or read conversations.

include_participants
boolean

Include normalized conversation attendees.

Aliases are shown independently because MCP clients send a flat JSON object. Use one alias from each required group, not every alias.

Common errors

insufficient_scope

Reconnect the MCP and approve the requested LinkedIn permission.

paid_plan_required

Use a SalesTouch workspace with LinkedIn MCP access.

On this page

When to use itRequirementsExampleParametersCommon errorsRelated tools