AGENTS.md — LinkedIn CLI Tool Reference for AI Agents

This file documents every tool available in the LinkedIn CLI / MCP server. AI agents (Claude Code, Cursor, Windsurf, OpenClaw, etc.) should use this as the authoritative reference for managing LinkedIn.

Authentication

Before using any tool, the agent needs LinkedIn session cookies. These are stored in ~/.linkedin-cli/config.json after running linkedin login, or can be set via environment variables:

LINKEDIN_LI_AT=<your li_at cookie>
LINKEDIN_JSESSIONID=<your JSESSIONID cookie>

To check if the session is valid:

linkedin status

Tool Reference

Profile Tools

`profile_me`

Get the authenticated user's own LinkedIn profile.

linkedin profile me

Parameters: None Returns: Full profile object (firstName, lastName, headline, entityUrn, publicIdentifier, etc.)

`profile_view`

View any LinkedIn profile by their public identifier (the URL slug).

linkedin profile view johndoe

Parameters:

Name	Type	Required	Description
`public_id`	string	yes	The public profile identifier from their LinkedIn URL

Returns: Full profile view including positions, education, languages, publications, certifications, skills

`profile_contact-info`

Get contact information for a profile (email, phone, websites, Twitter handles).

linkedin profile contact-info johndoe

Parameters:

Name	Type	Required	Description
`public_id`	string	yes	Public profile identifier

Returns: emailAddress, websites[], twitterHandles[], phoneNumbers[], birthDateOn

`profile_skills`

List skills for a profile.

linkedin profile skills johndoe --count 50

Parameters:

Name	Type	Required	Default	Description
`public_id`	string	yes	—	Public profile identifier
`count`	number	no	100	Number of skills to return (1-100)

`profile_network`

Get network info: connection count, follower count, connection distance, following state.

linkedin profile network johndoe

Parameters:

Name	Type	Required	Description
`public_id`	string	yes	Public profile identifier

`profile_badges`

Check if a profile has premium, influencer, job seeker, or open link badges.

linkedin profile badges johndoe

Parameters:

Name	Type	Required	Description
`public_id`	string	yes	Public profile identifier

Returns: { influencer, jobSeeker, openLink, premium } (booleans)

`profile_privacy`

Get privacy settings for a profile.

linkedin profile privacy johndoe

Parameters:

Name	Type	Required	Description
`public_id`	string	yes	Public profile identifier

`profile_posts`

List recent posts from a profile. Requires the numeric URN ID (not the public identifier).

linkedin profile posts ACoAABxxxxxxx --count 20

Parameters:

Name	Type	Required	Default	Description
`urn_id`	string	yes	—	Profile URN ID (numeric part)
`count`	number	no	10	Number of posts (1-100)
`start`	number	no	0	Pagination offset

`profile_disconnect`

Remove an existing connection (unfriend).

linkedin profile disconnect johndoe

Parameters:

Name	Type	Required	Description
`public_id`	string	yes	Public profile identifier

Post Tools

`posts_create`

Create a new LinkedIn post. Supports text-only and image posts.

linkedin posts create --text "Hello LinkedIn!"
linkedin posts create --text "Check this out" --image ./photo.jpg
linkedin posts create --text "For connections only" --visibility connections

Parameters:

Name	Type	Required	Default	Description
`text`	string	yes	—	Post text content (max 3000 chars)
`visibility`	enum	no	`anyone`	`anyone` or `connections`
`image`	string	no	—	File path to image to attach
`comments_scope`	enum	no	`all`	Who can comment: `all`, `connections`, `none`

`posts_edit`

Edit the text of an existing post.

linkedin posts edit "urn:li:share:12345" --text "Updated content"

Parameters:

Name	Type	Required	Description
`share_urn`	string	yes	The share URN of the post
`text`	string	yes	New post text (max 3000 chars)

`posts_delete`

Delete a post.

linkedin posts delete "urn:li:share:12345"

Parameters:

Name	Type	Required	Description
`share_urn`	string	yes	The share URN of the post to delete

Feed Tools

`feed_view`

View your LinkedIn feed in chronological order.

linkedin feed view --count 20

Parameters:

Name	Type	Required	Default	Description
`count`	number	no	10	Number of feed items (1-100)
`start`	number	no	0	Pagination offset

`feed_user`

View a specific user's activity feed.

linkedin feed user johndoe --count 20

Parameters:

Name	Type	Required	Default	Description
`profile_id`	string	yes	—	Public profile ID or URN ID
`count`	number	no	10	Number of items (1-100)
`start`	number	no	0	Pagination offset

`feed_company`

View a company's feed/updates.

linkedin feed company google --count 20

Parameters:

Name	Type	Required	Default	Description
`company_name`	string	yes	—	Company universal name (URL slug)
`count`	number	no	10	Number of items (1-100)
`start`	number	no	0	Pagination offset

Engagement Tools

`engage_react`

React to a post. Six reaction types available.

linkedin engage react 7123456789 --type LIKE

Parameters:

Name	Type	Required	Default	Description
`post_urn`	string	yes	—	Activity URN ID (numeric part)
`type`	enum	no	`LIKE`	Reaction type (see below)

Reaction types:

Value	Meaning
`LIKE`	Thumbs up
`PRAISE`	Celebrate (clapping)
`APPRECIATION`	Support (heart-hands)
`EMPATHY`	Love (heart)
`INTEREST`	Insightful (lightbulb)
`ENTERTAINMENT`	Funny (laughing)

`engage_reactions`

Get reactions on a post.

linkedin engage reactions 7123456789 --count 50

Parameters:

Name	Type	Required	Default	Description
`post_urn`	string	yes	—	Activity URN ID
`count`	number	no	10	Number of reactions (1-100)
`start`	number	no	0	Pagination offset

`engage_comment`

Comment on a post.

linkedin engage comment 7123456789 --text "Great post!"

Parameters:

Name	Type	Required	Description
`post_urn`	string	yes	Activity URN ID
`text`	string	yes	Comment text (max 1250 chars)

`engage_comments-list`

List comments on a post.

linkedin engage comments-list 7123456789 --sort REVERSE_CHRONOLOGICAL

Parameters:

Name	Type	Required	Default	Description
`post_urn`	string	yes	—	Activity URN ID
`count`	number	no	10	Number of comments (1-100)
`start`	number	no	0	Pagination offset
`sort`	enum	no	`RELEVANCE`	`RELEVANCE` or `REVERSE_CHRONOLOGICAL`

`engage_share`

Share/repost a post with optional commentary.

linkedin engage share "urn:li:share:12345" --text "This is worth reading"

Parameters:

Name	Type	Required	Description
`share_urn`	string	yes	Original share URN to repost
`text`	string	no	Optional commentary (max 3000 chars)

Connection Tools

`connections_send`

Send a connection request. Optional personalized message (max 300 chars).

linkedin connections send ACoAABxxxxxxx --message "Hi, I'd love to connect!"

Parameters:

Name	Type	Required	Description
`profile_urn`	string	yes	Profile URN ID
`message`	string	no	Personalized message (max 300 chars)

`connections_received`

List received (pending) connection invitations.

linkedin connections received --count 50

Parameters:

Name	Type	Required	Default	Description
`count`	number	no	100	Number of invitations (1-100)
`start`	number	no	0	Pagination offset

`connections_sent`

List sent (pending) connection invitations.

linkedin connections sent

Parameters:

Name	Type	Required	Default	Description
`count`	number	no	100	Number of invitations (1-100)
`start`	number	no	0	Pagination offset

`connections_accept`

Accept a connection invitation. Requires the invitation ID and shared secret (from the connections received response).

linkedin connections accept 12345 --secret abc123

Parameters:

Name	Type	Required	Description
`invitation_id`	string	yes	Invitation ID
`secret`	string	yes	Invitation shared secret

`connections_reject`

Reject/ignore a connection invitation.

linkedin connections reject 12345 --secret abc123

Parameters:

Name	Type	Required	Description
`invitation_id`	string	yes	Invitation ID
`secret`	string	yes	Invitation shared secret

`connections_withdraw`

Withdraw a pending sent connection request.

linkedin connections withdraw 12345

Parameters:

Name	Type	Required	Description
`invitation_id`	string	yes	Invitation ID to withdraw

`connections_remove`

Remove an existing connection.

linkedin connections remove johndoe

Parameters:

Name	Type	Required	Description
`public_id`	string	yes	Public profile identifier

Messaging Tools

`messaging_conversations`

List all messaging conversations.

linkedin messaging conversations

Parameters: None

`messaging_conversation-with`

Get the conversation with a specific person.

linkedin messaging conversation-with ACoAABxxxxxxx

Parameters:

Name	Type	Required	Description
`profile_urn`	string	yes	Profile URN ID of the person

`messaging_messages`

Get messages from a specific conversation.

linkedin messaging messages CONVERSATION_URN_ID
linkedin messaging messages CONVERSATION_URN_ID --before 1700000000000

Parameters:

Name	Type	Required	Description
`conversation_id`	string	yes	Conversation URN ID
`before`	number	no	Timestamp (ms) for pagination — get messages before this time

`messaging_send`

Send a message in an existing conversation.

linkedin messaging send CONVERSATION_URN_ID --text "Hello!"

Parameters:

Name	Type	Required	Description
`conversation_id`	string	yes	Conversation URN ID
`text`	string	yes	Message text

`messaging_send-new`

Start a new conversation with one or more people.

linkedin messaging send-new --recipients ACoAABxxxxxxx --text "Hi there!"
linkedin messaging send-new --recipients ACoAABxxxxxxx,ACoAAByyyyyyy --text "Group message"

Parameters:

Name	Type	Required	Description
`recipients`	string	yes	Comma-separated profile URN IDs
`text`	string	yes	Message text

`messaging_mark-read`

Mark a conversation as read.

linkedin messaging mark-read CONVERSATION_URN_ID

Parameters:

Name	Type	Required	Description
`conversation_id`	string	yes	Conversation URN ID

Search Tools

`search_people`

Search for people with advanced filters.

linkedin search people --keywords "software engineer" --network F
linkedin search people --title "VP Sales" --company 1035 --geo 103644278

Parameters:

Name	Type	Required	Default	Description
`keywords`	string	no	—	Search keywords
`network`	enum	no	—	Connection depth: `F` (1st), `S` (2nd), `O` (3rd+)
`company`	string	no	—	Current company ID
`industry`	string	no	—	Industry ID
`school`	string	no	—	School ID
`title`	string	no	—	Title filter
`first_name`	string	no	—	First name filter
`last_name`	string	no	—	Last name filter
`geo`	string	no	—	Geographic region URN
`limit`	number	no	10	Results per page (max 49)
`start`	number	no	0	Pagination offset

`search_companies`

Search for companies.

linkedin search companies --keywords "AI startups"

Parameters:

Name	Type	Required	Default	Description
`keywords`	string	yes	—	Search keywords
`limit`	number	no	10	Results per page (max 49)
`start`	number	no	0	Pagination offset

`search_jobs`

Search for jobs with filters for experience, type, location, remote, and recency.

linkedin search jobs --keywords "product manager" --remote --experience 4
linkedin search jobs --keywords "engineer" --location "San Francisco" --job-type F

Parameters:

Name	Type	Required	Default	Description
`keywords`	string	yes	—	Job search keywords
`location`	string	no	—	Location filter
`experience`	string	no	—	Level: `1`=Intern, `2`=Entry, `3`=Assoc, `4`=Mid, `5`=Dir, `6`=Exec
`job_type`	string	no	—	Type: `F`=Full, `C`=Contract, `P`=Part, `T`=Temp, `I`=Intern
`remote`	boolean	no	—	Filter for remote jobs
`posted_within`	string	no	—	Recency: `r86400`=24h, `r604800`=week, `r2592000`=month
`count`	number	no	25	Results per page (max 49)
`start`	number	no	0	Pagination offset

`search_posts`

Search for posts/content.

linkedin search posts --keywords "AI trends 2026"

Parameters:

Name	Type	Required	Default	Description
`keywords`	string	yes	—	Search keywords
`limit`	number	no	10	Results per page (max 49)
`start`	number	no	0	Pagination offset

Company Tools

`companies_view`

View a company profile.

linkedin companies view google

Parameters:

Name	Type	Required	Description
`company_name`	string	yes	Company universal name (URL slug from their LinkedIn URL)

`companies_follow`

Follow a company.

linkedin companies follow "urn:li:fs_followingInfo:12345"

Parameters:

Name	Type	Required	Description
`following_state_urn`	string	yes	Following state URN

`companies_unfollow`

Unfollow a company or entity.

linkedin companies unfollow "urn:li:fs_followingInfo:12345"

Parameters:

Name	Type	Required	Description
`entity_urn`	string	yes	Entity URN to unfollow

Job Tools

`jobs_view`

Get details for a specific job posting.

linkedin jobs view 3456789012

Parameters:

Name	Type	Required	Description
`job_id`	string	yes	Job posting ID

`jobs_skills`

Get skill match insights for a job posting (how your skills match).

linkedin jobs skills 3456789012

Parameters:

Name	Type	Required	Description
`job_id`	string	yes	Job posting ID

Analytics Tools

`analytics_profile-views`

Get "who viewed my profile" summary and view count.

linkedin analytics profile-views

Parameters: None

Output Formats

All tools return JSON by default. Use these flags to control output:

linkedin profile me                     # Compact JSON (default)
linkedin profile me --pretty            # Pretty-printed JSON
linkedin profile me --fields "firstName,lastName,headline"  # Only specific fields
linkedin profile me --quiet             # No output, exit code only

Rate Limiting

LinkedIn has aggressive rate limiting. The client automatically:

Enforces minimum 1-second gaps between requests
Retries on 429 (rate limit) and 5xx errors with exponential backoff
Detects CAPTCHA/challenge pages and throws a clear error

For bulk operations, add your own delays between calls.

Common URN Patterns

Entity	URN Format	Example
Profile	`urn:li:fsd_profile:{id}`	`urn:li:fsd_profile:ACoAABxxxxxxx`
Activity	`urn:li:activity:{id}`	`urn:li:activity:7123456789`
Share	`urn:li:share:{id}`	`urn:li:share:7123456789`
Company	`urn:li:company:{id}`	`urn:li:company:1035`
Conversation	`urn:li:fs_conversation:{id}`	`urn:li:fs_conversation:abc123`
Invitation	`urn:li:invitation:{id}`	`urn:li:invitation:12345`

FilesExpand file tree

AGENTS.md

Latest commit

History

AGENTS.md

File metadata and controls

AGENTS.md — LinkedIn CLI Tool Reference for AI Agents

Authentication

Tool Reference

Profile Tools

profile_me

profile_view

profile_contact-info

profile_skills

profile_network

profile_badges

profile_privacy

profile_posts

profile_disconnect

Post Tools

posts_create

posts_edit

posts_delete

Feed Tools

feed_view

feed_user

feed_company

Engagement Tools

engage_react

engage_reactions

engage_comment

engage_comments-list

engage_share

Connection Tools

connections_send

connections_received

connections_sent

connections_accept

connections_reject

connections_withdraw

connections_remove

Messaging Tools

messaging_conversations

messaging_conversation-with

messaging_messages

messaging_send

messaging_send-new

messaging_mark-read

Search Tools

search_people

search_companies

search_jobs

search_posts

Company Tools

companies_view

companies_follow

companies_unfollow

Job Tools

jobs_view

jobs_skills

Analytics Tools

analytics_profile-views

Output Formats

Rate Limiting

Common URN Patterns

`profile_me`

`profile_view`

`profile_contact-info`

`profile_skills`

`profile_network`

`profile_badges`

`profile_privacy`

`profile_posts`

`profile_disconnect`

`posts_create`

`posts_edit`

`posts_delete`

`feed_view`

`feed_user`

`feed_company`

`engage_react`

`engage_reactions`

`engage_comment`

`engage_comments-list`

`engage_share`

`connections_send`

`connections_received`

`connections_sent`

`connections_accept`

`connections_reject`

`connections_withdraw`

`connections_remove`

`messaging_conversations`

`messaging_conversation-with`

`messaging_messages`

`messaging_send`

`messaging_send-new`

`messaging_mark-read`

`search_people`

`search_companies`

`search_jobs`

`search_posts`

`companies_view`

`companies_follow`

`companies_unfollow`

`jobs_view`

`jobs_skills`

`analytics_profile-views`