Fetches your LinkedIn profile and recent activity as structured JSON for use in AI assistants and command-line interfaces.
Also known as larsbaunwall/unlinked, @larsbaunwall/unlinked
- Stars
- 4
- Tools
- 4
- Downloads, 30 days
- 233
- Latest version
- 2.0.0
- Last commit
- Oct 7, 2026
- License
- MIT
What is Unlinked MCP?
Unlinked fetches your LinkedIn profile and recent activity as structured JSON for use in AI assistants and command-line interfaces. It exposes 4 tools, such as linkedin_get_profile, linkedin_get_section, linkedin_get_recent_activity.
Summary generated from the project's README
About Unlinked MCP server
Unlinked provides a way to access your own LinkedIn profile and activity as structured JSON data. It is designed for developers and users who want to feed their professional information into AI assistants or command-line interfaces. The server works by reading from the official LinkedIn Member Data Portability API, which is currently restricted to members located in Switzerland and the European Economic Area.
Users can run this as a local CLI or as an MCP server for clients like Claude Desktop and GitHub Copilot. To use it, you must provide a LinkedIn access token via the LINKEDIN_TOKEN environment variable. The server includes a unique feature that merges recent changes from the last 28 days into the data, ensuring that recent profile edits, posts, or comments are included even if the official data export is lagging.
It offers four read-only tools: linkedin_get_profile, linkedin_get_section, linkedin_get_recent_activity, and linkedin_check_access. The system uses a cache to reduce API load, which can be configured via the UNLINKED_CACHE_TTL variable.
Written from the project's README. Every use case is checked against a quote from it.
How to install Unlinked MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Unlinked MCP in Claude Code
$ claude mcp add --env 'LINKEDIN_TOKEN=<YOUR_LINKEDIN_TOKEN>' unlinked -- npx -y @larsbaunwall/unlinkedInstall Unlinked MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"unlinked": {
"command": "npx",
"args": [
"-y",
"@larsbaunwall/unlinked"
],
"env": {
"LINKEDIN_TOKEN": "<YOUR_LINKEDIN_TOKEN>"
}
}
}
}Install Unlinked MCP in VS Code
.vscode/mcp.json
{
"servers": {
"unlinked": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@larsbaunwall/unlinked"
],
"env": {
"LINKEDIN_TOKEN": "<YOUR_LINKEDIN_TOKEN>"
}
}
}
}Install Unlinked MCP in VS Code CLI
$ code --add-mcp '{"name":"unlinked","type":"stdio","command":"npx","args":["-y","@larsbaunwall/unlinked"],"env":{"LINKEDIN_TOKEN":"<YOUR_LINKEDIN_TOKEN>"}}'Install Unlinked MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"unlinked": {
"command": "npx",
"args": [
"-y",
"@larsbaunwall/unlinked"
],
"env": {
"LINKEDIN_TOKEN": "<YOUR_LINKEDIN_TOKEN>"
}
}
}
}Install Unlinked MCP in Codex
$ codex mcp add unlinked --env 'LINKEDIN_TOKEN=<YOUR_LINKEDIN_TOKEN>' -- npx -y @larsbaunwall/unlinkedInstall Unlinked MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.unlinked] command = "npx" args = ["-y", "@larsbaunwall/unlinked"] [mcp_servers.unlinked.env] LINKEDIN_TOKEN = "<YOUR_LINKEDIN_TOKEN>"
Install Unlinked MCP in Gemini CLI
$ gemini mcp add -s user -e 'LINKEDIN_TOKEN=<YOUR_LINKEDIN_TOKEN>' unlinked npx -- -y @larsbaunwall/unlinkedInstall Unlinked MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"unlinked": {
"command": "npx",
"args": [
"-y",
"@larsbaunwall/unlinked"
],
"env": {
"LINKEDIN_TOKEN": "<YOUR_LINKEDIN_TOKEN>"
}
}
}
}Needs a key before it starts
Started on 16 Nov 2026 with no keys, it stopped and asked for one, so a client sees no tools until you set the variables above.
Unlinked MCP tools 4
Detected from the READMElinkedin_get_profilelinkedin_get_sectionlinkedin_get_recent_activitylinkedin_check_access
Configuration
LINKEDIN_TOKENRequiredSecretLinkedIn access token from the OAuth Token Generator. Accepts a bare token or 'Bearer <token>'. Required for EEA/Switzerland members only.
UNLINKED_CACHE_TTLHow long fetched LinkedIn data is cached in memory, e.g. 30m, 2h, 1d, or 0 to turn caching off. Defaults to 6h.
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablelarsbaunwall/unlinked is public and reachablegithub.com/larsbaunwall/unlinked ↗Pass
- Package names this repository as its source@larsbaunwall/unlinked names larsbaunwall/unlinked as sourcenpmjs.com/package/@larsbaunwall/unlinked ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @larsbaunwall/unlinkednpmjs.com/package/@larsbaunwall/unlinked/v/2.0.0#provenance ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-07github.com/larsbaunwall/unlinked ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @larsbaunwall/unlinkedPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubUnlinked
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 profileprints your profile as JSON. - MCP server:
unlinked --mcpgives 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": "<your_access_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": "<your_access_token>"
}
}
}
}
Tools
| Tool | What it does |
|---|---|
linkedin_get_profile |
Your résumé in one call, with recent edits included. Larger sections come back as links. |
linkedin_get_section |
One section, a page at a time (limit 1-200, default 50, plus cursor). |
linkedin_get_recent_activity |
What changed in the last 28 days: profile edits, posts, comments, reactions. |
linkedin_check_access |
Whether LinkedIn is sharing recent changes with this app. |
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 <id>.
| Section id | On LinkedIn | Notes |
|---|---|---|
intro |
Intro + About | In the default profile |
experience |
Experience | In the default profile |
education |
Education | In the default profile |
skills |
Skills | In the default profile |
certifications |
Licenses & certifications | In the default profile |
projects |
Projects | In the default profile |
languages, volunteering, honors, courses, publications, patents, test-scores, organizations, causes, services |
Languages, Volunteering, Honors & awards, Courses, Publications, Patents, Test scores, Organizations, Causes, Services | With profile --all |
recommendations |
Recommendations | With profile --all. Received and given are mixed; LinkedIn does not say which is which |
posts, comments, reactions, reposts, articles |
Activity | Paged. Recent posts, comments and reactions are merged in |
connections, invitations |
My Network | Paged. Email addresses are removed |
followed-companies, followed-people, groups |
Interests | Paged |
saved-jobs, job-applications, job-preferences, job-postings |
Jobs | Paged. Contact details and addresses are removed |
endorsements-given |
Endorsements you gave | Paged |
learning |
LinkedIn Learning history | Paged |
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
| Environment variable | Required | Description |
|---|---|---|
LINKEDIN_TOKEN |
Yes | LinkedIn access token. Accepts Bearer <token> or a bare token. |
UNLINKED_CACHE_TTL |
No | Cache lifetime: 30m, 2h, 1d, or 0 to turn it off. Defaults to 6h. |
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
--mcpinargs. Without it Unlinked runs as a CLI and exits. - Five tools became four:
linkedin_get_profile,linkedin_get_section,linkedin_get_recent_activityandlinkedin_check_access.linkedin_get_activity,linkedin_get_recent_changesand thedomain/maxPagesinputs 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
startTimepolling. - 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 clearto 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
Unlinked MCP questions
How do I add Unlinked MCP to Claude Code?
Run claude mcp add --env 'LINKEDIN_TOKEN=<YOUR_LINKEDIN_TOKEN>' unlinked -- npx -y @larsbaunwall/unlinked in your terminal. Add --scope user to make it available in every project.
How do I add Unlinked MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Unlinked MCP provide?
It exposes 4 tools, including linkedin_get_profile, linkedin_get_section, linkedin_get_recent_activity, linkedin_check_access.
Where is this service available?
It is only available to members located in the European Economic Area (EEA) and Switzerland.
What kind of data can I retrieve?
You can access your profile sections like experience, education, and skills, as well as recent activity like posts, comments, and reactions.
Does it include sensitive information like messages or email addresses?
No, sensitive data such as messages, login history, phone numbers, and email addresses are never read.
How fresh is the data provided?
The tool merges recent changes from the last 28 days into the data, so recent edits or comments are included.