> ## Documentation Index
> Fetch the complete documentation index at: https://talktohumans.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> Connect AI clients to your LinkedIn data

The TalkToHumans MCP lets AI clients (like Claude Cowork, Claude Code, Codex, or Cursor) securely interact with your LinkedIn workspace data.

It is designed for AI agents that need real-time access to workspace data and can benefit from the structured tool outputs.

Server:

```text theme={null}
https://api.talktohumans.app/mcp
```

## How to install

### Claude Code

In a terminal, run:

```bash theme={null}
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.

### Codex

In a terminal, run:

```bash theme={null}
codex mcp add talktohumans --url https://api.talktohumans.app/mcp
codex mcp login talktohumans
```

### Claude (Web)

1. Go to [**claude.ai/settings/integrations**](https://claude.ai/settings/integrations)
2. Click **Add custom connector**
3. Enter the name "TalkToHumans" and paste the remote MCP server URL:

```text theme={null}
https://api.talktohumans.app/mcp
```

4. Then click **Connect** in the connectors list

Start a new chat and TalkToHumans's tools will appear in the tools menu.

### Claude App (MacOS / Windows)

1. Open **Settings** > **Connectors** or **Customize** > **Connectors**
2. Click **Add Connector** and enter the URL:

```text theme={null}
https://api.talktohumans.app/mcp
```

3. Complete the sign-in flow to connect your TalkToHumans account

### ChatGPT (Web)

1. In ChatGPT, go to **Settings > Apps > Create**
2. Enter the name "TalkToHumans" and paste the URL:

```text theme={null}
https://api.talktohumans.app/mcp
```

3. Click **Create** and complete the OAuth flow to connect your TalkToHumans account

### Cursor

```json theme={null}
{
  "mcpServers": {
    "talktohumans": {
      "url": "https://api.talktohumans.app/mcp"
    }
  }
}
```

### VS Code

```json theme={null}
{
  "servers": {
    "talktohumans": {
      "type": "http",
      "url": "https://api.talktohumans.app/mcp"
    }
  }
}
```

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

## MCP tools available

| Tool                                              | Purpose                                                                   |
| ------------------------------------------------- | ------------------------------------------------------------------------- |
| `talktohumans_linkedin_list_accounts`             | See which LinkedIn accounts are connected.                                |
| `talktohumans_linkedin_search_contacts`           | Find people by name, company, role, tag, location, or relationship state. |
| `talktohumans_linkedin_search_network`            | Find connected LinkedIn contacts only.                                    |
| `talktohumans_linkedin_search_conversations`      | Find LinkedIn or Sales Navigator threads by contact or participant tag.   |
| `talktohumans_linkedin_get_conversation_messages` | List message history for a specific conversation.                         |
| `talktohumans_linkedin_create_contact_view`       | Creates a contact list/view filtered by specific contacts.                |
| `talktohumans_linkedin_update_contact`            | Update a specific contact's details, including tags and notes.            |
| `talktohumans_linkedin_enrich_profile`            | Enrich a LinkedIn member profile and its primary company in TalkToHumans. |