TalkToHumans MCP

official

Securely search your LinkedIn network and conversations to find warm leads, intros, partners, candidates, and opportunities.

View on talktohumans.app

What can you do with TalkToHumans MCP?

  • List and manage contacts — Ask your assistant to pull up your LinkedIn network connections and imported contacts, or update their tags and notes.
  • Enrich profiles and find contact info — Have your assistant enrich a contact's profile or locate their work email and mobile phone number.
  • Draft and manage outreach — Ask your assistant to create message drafts, connection request notes, or sequences, and list or update your message templates.
  • Track and summarize activity — Get your assistant to list your LinkedIn outreach activity or summarize reply rates, acceptance rates, and template performance.
  • Organize with saved views — Ask your assistant to list, create, or update custom inboxes, contact views, and company views with your preferred filters and sorting.

Documentation

MCP

Connect AI clients to your LinkedIn data

The TalkToHumans MCP lets AI clients securely interact with your LinkedIn data.

https://api.talktohumans.app/mcp

How to install

Claude Code

In a terminal, run:

claude mcp add --transport http talktohumans https://api.talktohumans.app/mcp

Then authenticate by running /mcp in Claude Code and following the sign-in flow. Add --scope user to make the server available in all your projects.

Codex

In a terminal, run:

codex mcp add talktohumans --url https://api.talktohumans.app/mcp
codex mcp login talktohumans

In the Codex app or IDE extension, you can also open Settings > MCP servers, click Add server, choose Streamable HTTP, paste the URL, then click Authenticate.

Claude (Web)

  1. Go to claude.ai and open Customize > Connectors
  2. Click + > Add custom connector
  3. Enter the name "TalkToHumans" and paste the remote MCP server URL:
https://api.talktohumans.app/mcp
  1. Click Add, then click Connect on the connector and complete the sign-in flow

To use it, click + in the chat box, open Connectors, and toggle TalkToHumans on.

On Team and Enterprise plans, an organization Owner must first add the connector in Organization settings > Connectors. Members then connect from Customize > Connectors.

Claude App (MacOS / Windows)

  1. Open Customize > Connectors
  2. Click + > Add custom connector and enter the URL:
https://api.talktohumans.app/mcp
  1. Complete the sign-in flow to connect your TalkToHumans account

ChatGPT (Web)

  1. In ChatGPT, go to Settings > Security and login and turn on Developer mode (Business and Enterprise workspaces may need an admin to allow it)
  2. Open chatgpt.com/plugins and click the + button
  3. Enter the name "TalkToHumans" and paste the URL:
https://api.talktohumans.app/mcp
  1. Create the connection and complete the OAuth flow to connect your TalkToHumans account

Start a new chat and add TalkToHumans from the tools menu in the message box.

Cursor

Add this to .cursor/mcp.json (current project) or ~/.cursor/mcp.json (all projects):

{
  "mcpServers": {
    "talktohumans": {
      "url": "https://api.talktohumans.app/mcp"
    }
  }
}

Cursor will prompt you to sign in the first time the server is used.

VS Code

Run MCP: Add Server from the Command Palette, or add this to .vscode/mcp.json (run MCP: Open User Configuration to make it available in all workspaces):

{
  "servers": {
    "talktohumans": {
      "type": "http",
      "url": "https://api.talktohumans.app/mcp"
    }
  }
}

VS Code will prompt you to sign in when you start the server.

After adding the server, complete the OAuth flow in the client. The connected user must belong to a workspace with TalkToHumans API access.

Try a product workflow

Find contacts, draft outreach, and build team reports with your AI client.

MCP tools available

Accounts

`linkedin_list_accounts` 
List the LinkedIn accounts connected to the workspace.

Contacts

`linkedin_list_contacts` 
List network connections and imported LinkedIn contacts.
`linkedin_import_contacts` 
Import up to 500 LinkedIn contacts from member profile URLs.
`linkedin_get_contact_import` 
Check an import's progress and per-profile results.
`linkedin_update_contact` 
Update a LinkedIn contact's tags, plain-text notes, and custom-field values.
`linkedin_list_field_definitions` 
List custom-field definitions for LinkedIn contacts.

Companies

`linkedin_list_companies` 
List LinkedIn companies.

Enrich

`linkedin_enrich_profile` 
Enrich a contact profile and its primary company.
`linkedin_find_email` 
Find a LinkedIn contact's work email.
`linkedin_find_phone` 
Find a LinkedIn contact's mobile phone number.

Views

`linkedin_list_views` 
List saved inboxes, contact views, and company views.
`linkedin_create_view` 
Create an inbox, contact view, or company view with filters, sorts, and grouping.
`linkedin_update_view` 
Update a view's name, filters, sorts, grouping, or display settings.

Conversations

`linkedin_list_conversations` 
List LinkedIn conversations.
`linkedin_get_conversation_messages` 
Get the messages in a LinkedIn conversation.
`linkedin_create_message_draft` 
Draft a message, connection request note, or sequence for a contact, from plain text or a template.

Templates

`linkedin_list_templates` 
List shared and personal message and sequence templates.
`linkedin_create_template` 
Create a shared or personal message or sequence template.
`linkedin_update_template` 
Update a template's name, message content, or sequence steps.

Activity and reporting

`activity_list` 
List LinkedIn activity for reporting.
`activity_summary` 
Summarize outreach, replies, acceptance rates, and template performance.

This documentation is built and hosted on Mintlify, a developer documentation platform.