Unlinked

Unlinked

Your LinkedIn profile, up to date, in one call. From your terminal or from your AI assistant.

Unlinked reads your own data from LinkedIn's official Member Data Portability API and hands it over as tidy JSON. It works two ways:

• CLI: unlinked profile prints your profile as JSON.
• MCP server: unlinked --mcp gives Model Context Protocol clients such as Claude Desktop and GitHub Copilot four read-only tools.

LinkedIn's data export can lag behind what you just did. Unlinked also reads your recent changes (the last 28 days) and merges them in, so a headline you edited yesterday or a comment you wrote last week is already there.

:eu: EEA / Switzerland only. LinkedIn's Member Data Portability API is currently available only to members located in the European Economic Area and Switzerland. Thank you, Digital Markets Act (DMA)!

:warning: Use at your own risk. You use Unlinked entirely on your own responsibility. See the Disclaimer.

Quickstart

You need Node.js 22+ and a member access token from the LinkedIn OAuth Token Generator (it requires a LinkedIn Developer app with the Member Data Portability API (Member) product).

LINKEDIN_TOKEN=<your_access_token> npx -y @larsbaunwall/unlinked profile

unlinked profile                          # résumé: intro, experience, education, skills, certifications, projects

unlinked profile --sections skills,languages unlinked profile --all # every résumé section unlinked section reactions --limit 20 # one section, a page at a time, newest first unlinked section posts --all-items # everything in a section, for exports unlinked activity --since 7d # what changed recently unlinked status # is LinkedIn sharing recent changes with this app? unlinked cache clear

Results are JSON on stdout (use --compact for one line). Errors are JSON on stderr, with exit code 1 for LinkedIn or token problems and 2 for usage mistakes such as an unknown section.

Use it from an AI assistant

Add --mcp so Unlinked runs as an MCP server.

Claude Desktop

Add to your claude_desktop_config.json:

{

"mcpServers": { "unlinked": { "command": "npx", "args": ["-y", "@larsbaunwall/unlinked", "--mcp"], "env": { "LINKEDIN_TOKEN": " " } } } }

The config file is typically at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

GitHub Copilot (VS Code)

Add to your user-level MCP config or a workspace .vscode/mcp.json:

{

"servers": { "unlinked": { "command": "npx", "args": ["-y", "@larsbaunwall/unlinked", "--mcp"], "env": { "LINKEDIN_TOKEN": " " } } } }

Tools

All four are read-only. Each returns structured JSON plus a one-line summary.

Sections

Sections use the names you see on LinkedIn. profile embeds the small ones; the big ones (marked paged) are fetched with section .

Sensitive data is never read: messages, login history, phone numbers, email addresses, contacts, ads, searches, receipts and similar. Private details inside the sections above (birth date, home address and so on) are removed.

Featured, your profile photo and banner, and contact info (beyond websites) are not in LinkedIn's API, so Unlinked cannot return them.

Freshness and cache

Every answer has a freshness block: when the data was fetched (asOf), how many recent changes were merged in, which sections have edits LinkedIn's export does not show yet (pendingEdits), and which came back empty.

An empty section has two possible meanings: you have no entries there, or LinkedIn has not prepared it yet (new data can take up to 24 hours after you first grant consent).

To be kind to LinkedIn's API, results are cached for up to 6 hours. The CLI keeps the cache in your OS cache folder (readable only by you, never containing your token); the MCP server keeps it in memory only.

unlinked profile --refresh     # fetch fresh data now

unlinked profile --no-cache # do not read or write the cache unlinked cache clear # delete the cached files UNLINKED_CACHE_TTL=30m # change the lifetime (30m, 2h, 1d, or 0 for off)

Configuration

LINKEDIN_API_VERSION is no longer used. LinkedIn accepts only version 202312 for this API, so Unlinked always sends that and warns on stderr if the variable is set to anything else.

Upgrading from 1.x

2.0 is a breaking release.

• MCP configs need `--mcp` in args. Without it Unlinked runs as a CLI and exits.
• Five tools became four: linkedin_get_profile, linkedin_get_section, linkedin_get_recent_activity and linkedin_check_access. linkedin_get_activity, linkedin_get_recent_changes and the domain/maxPages inputs are gone.
• Sections use LinkedIn's UI names (experience, reactions) instead of internal ones (POSITIONS, ALL_LIKES), and rows use camelCase keys without empty values.
• Recent changes are merged into the data for you; there is no startTime polling.
• Sensitive sections are blocked, and private fields are removed.

Security

• Treat tool output as untrusted data. Sections such as recommendations you received, invitation messages, and connection names and headlines contain text written by other people. An assistant should read it as data and never follow instructions found in it (prompt injection).
• The disk cache is plaintext. The CLI cache (up to 6 hours, readable only by you) holds your profile plus connections, invitations and job-application data, unencrypted. Your token is never written to it. Run unlinked cache clear to remove it. The MCP server keeps its cache in memory only.

Development

npm install

npm run build npm test npm run typecheck npm run dev -- profile # run from source with .env npm run inspect # try the MCP server in MCP Inspector (build first)

See AGENTS.md for implementation guidance.

Disclaimer

Use of Unlinked is at your sole risk and responsibility.

Unlinked is provided "as is" and "as available", without warranty of any kind, express or implied. It is an independent, unofficial open-source project. It is not affiliated with, endorsed by, or sponsored by LinkedIn, GitHub, or Microsoft.

By installing or using Unlinked, you accept that:

• You are solely responsible for how you use it and for everything that follows from that use. This includes your LinkedIn access token and its storage, the data you retrieve, the local cache on your machine, and the AI assistants, MCP clients, and third-party services you give that data to.
• You are responsible for compliance with LinkedIn's terms, policies, and API product terms, with applicable laws (including data protection law such as the GDPR), and with the terms of any AI assistant or service you connect. Your LinkedIn account and API access may be limited, suspended, or terminated by LinkedIn.
• You bear all risk of loss, damage, or harm of any kind, including loss or exposure of data, account restrictions, incorrect or outdated output, and actions taken by AI assistants based on that output.
• The developer and contributors accept no liability and, to the fullest extent permitted by law, disclaim all liability for any claim, damage, or loss, whether direct, indirect, incidental, special, consequential, or otherwise, and whether in contract, tort, or otherwise, arising from or in connection with Unlinked or its use. You release them from any such claim and agree to indemnify and hold them harmless against any claim brought by a third party that arises from your use of Unlinked.

Nothing in this notice limits any liability that cannot be excluded under applicable law. This notice supplements the MIT License, which also applies.

License

MIT