io.github.larsbaunwall/unlinked
MCP server that brings your LinkedIn professional profile and experience into your context.
Open source Open in the app JSON README (API)
About
MCP server that brings your LinkedIn professional profile and experience into your context.
Details
- Kind
- MCP servers
- Topic
- Social & content
- Publisher
- larsbaunwall
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.4
- Stars
- 3
- Last push
- 2026-05-10T20:15:05Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 04:00:22
- Updated
- 2026-08-29 04:00:22
- Origin id
io.github.larsbaunwall/unlinked
README
# <img src="logo.png" alt="Unlinked logo" width="40" /> Unlinked
Bring your LinkedIn professional profile into AI assistants — without copy-pasting, scraping, or guessing.
---
Unlinked is a TypeScript MCP server that connects your LinkedIn professional profile and experience to any [Model Context Protocol](https://modelcontextprotocol.io/) client — Claude Desktop, GitHub Copilot, and others. It reads your data directly from LinkedIn's official [Member Data Portability API](https://learn.microsoft.com/en-us/linkedin/dma/member-data-portability/member-data-portability-member/), so your assistant always has accurate, up-to-date context about who you are professionally.
> :eu: **EEA / Switzerland only.** LinkedIn's Member Data Portability API is currently available exclusively to members located in the European Economic Area and Switzerland. Thank you, Digital Markets Act (DMA)!
## What it does
Once connected, your AI assistant can:
- **Read your full professional profile** — positions, education, skills, certifications, projects, languages, honours, publications, patents, and more
- **Fetch any specific LinkedIn data domain** by name
- **Poll for recent profile changes** via the LinkedIn changelog API
- **Diagnose authorization status** so you can quickly identify consent or permission issues
All data access is read-only. Your access token is used only to talk to LinkedIn and is never stored, logged, or echoed back.
## Prerequisites
- Node.js 22+
- A LinkedIn Developer app with the **Member Data Portability API (Member)** product enabled (follow [this guide](https://learn.microsoft.com/en-us/linkedin/dma/member-data-portability/member-data-portability-member/?view=li-dma-data-portability-2025-11))
- A [member access token](https://learn.microsoft.com/en-us/linkedin/dma/member-data-portability/member-data-portability-member/?view=li-dma-data-portability-2025-11#getting-an-access-token) from the LinkedIn OAuth Token Generator (requires EEA/Switzerland membership)
## Setup
### Claude Desktop
Add to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"unlinked": {
"command": "npx",
"args": ["-y", "@larsbaunwall/unlinked"],
"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 (`File → Preferences → MCP Servers`) or a workspace `.vscode/mcp.json`:
```json
{
"servers": {
"unlinked": {
"command": "npx",
"args": ["-y", "@larsbaunwall/unlinked"],
"env": {
"LINKEDIN_TOKEN": "<your_access_token>"
}
}
}
}
```
## Tools
| Tool | Description |
| --- | --- |
| `linkedin_get_profile` | Get the user's LinkedIn résumé: bio, work history, education, skills, certifications, projects, etc. |
| `linkedin_get_activity` | Get the user's LinkedIn activity: connections, posts, articles, comments, likes, job applications |
| `linkedin_get_section` | Get raw data for one specific LinkedIn section by exact name |
| `linkedin_get_recent_changes` | Get recent changes to the user's LinkedIn data (past 28 days), with cursor-based polling |
| `linkedin_check_access` | Check whether the user has granted LinkedIn data access — useful for diagnosing missing data |
## Configuration
| Environment variable | Required | Description |
| --- | --- | --- |
| `LINKEDIN_TOKEN` | Yes | LinkedIn access token. Accepts `Bearer <token>` or a bare token. |
| `LINKEDIN_API_VERSION` | No | API version in `YYYYMM` format. Defaults to `202312`. |
## Development
```bash
npm install
npm run build
npm run dev # run directly from source with .env
npm run inspect # test with MCP Inspector
```
See [AGENTS.md](AGENTS.md) for implementation guidance.
## License
MIT