LinkedIn CLI for AI agents

tth connects Claude Code, Codex, Cursor or any agent with a terminal to your LinkedIn conversations, network, contacts and drafts. It also runs in scripts and cron jobs.

tth never sends a LinkedIn message. It writes drafts, and you review and send them in TalkToHumans.

Quickstart

# Install (macOS and Linux)
brew install talktohumans/tap/tth

# Sign in (opens a browser)
tth auth login

# List your contacts
tth contacts list --query "Acme"

On Windows or without Homebrew, download tth from the latest release and put it on your PATH. Any member of a Pro workspace can sign in. Scripts and cron jobs use an API key instead: export TTH_API_KEY=sk_....

Set up your AI agent

Install the agent skill once:

tth skill --install

Or with any skills installer: npx skills add TalkToHumans/linkedin-cli. Then ask in plain words, like the prompts in our use cases. Your agent loads the same playbooks as the MCP with tth skills show.

Common commands

# Conversations where you owe a reply
tth conversations list --account-id 42 --filters '[{"field":"conversation.reply_state","operator":"=","value":"waiting_for_my_reply"}]'

# Import profiles and wait for the result
tth contacts import --account-id 42 --file leads.txt --wait

# Enrich and tag a contact
tth contacts enrich --contact-id 123
tth contacts update 123 --tag "Hot lead"

# Draft a message (never sent)
tth drafts write --account-id 42 --contact-id 123 --draft-message "Hi Ada, ..."

# Last week's performance
tth activity summary --from 2026-10-19 --to 2026-10-26

Every command supports --help, starting with real examples:

tth contacts --help
tth drafts write --help

Find your account IDs with tth accounts list.

JSON output for scripting

tth prints a table in a terminal and JSON when piped, so it fits in jq and shell scripts. --json forces JSON, and --all fetches every page into one array:

tth conversations list --all | jq length

Errors go to stderr. Exit codes: 0 ok, 1 error, 2 usage, 3 not found, 4 auth, plan or setup, 5 rate limited.

Command groups

Group	Purpose
`auth`	Sign in, check the current workspace, sign out
`accounts`, `credits`	Connected LinkedIn accounts and credits
`conversations`, `messages`, `drafts`	Read conversations and write drafts
`contacts`, `companies`	Find, import, enrich, tag and update contacts
`fields`, `tags`, `views`	Custom fields, tags and saved views
`templates`, `sequences`	Message templates and follow-up sequences
`activity`	Activity and performance reports
`skill`, `skills`, `feedback`	Agent skill, playbooks and feedback
`api`	Call any `/v1` route of the API

Conversations

Templates

Contacts

Companies

Custom fields

Tags

Enrich

Views

Sequences

Accounts

Activity

Agents

LinkedIn CLI for AI agents

Quickstart

Set up your AI agent

Common commands

JSON output for scripting

Command groups

Use cases to try out

Use with your AI tools

References

GitHub

API Reference

​Quickstart

​Set up your AI agent

​Common commands

​JSON output for scripting

​Command groups

​Use cases to try out

Use with your AI tools

​References

GitHub

API Reference

Quickstart

Set up your AI agent

Common commands

JSON output for scripting

Command groups

Use cases to try out

References