link — Claude Code MCP server: what it does, how to install
link keeps shared agent memory in local Markdown files and retrieves it by meaning. Use it when you want agents to carry project decisions and preferences across sessions.
claude mcp add link -- uvx link-mcpWhat link does
link turns notes, transcripts, documents, and project context into a local knowledge base. Source material goes into raw/; pages backed by those sources live in wiki/. Agents can propose preferences, decisions, and facts for review, then retrieve compact context through MCP or the CLI.
Memory stays in Markdown files you can inspect. Nothing becomes durable until you approve it, so automatic session capture does not silently add facts to your memory. For Claude Code, the setup command is claude mcp add link -- uvx link-mcp. The project’s quick start also shows brew install gowtham0992/link/link followed by lnk setup.
What it helps with
- carry agent preferences and decisions across sessions
- turn local notes and documents into a knowledge base
- retrieve relevant context by meaning rather than matching keywords
- share project context among local agents
Example prompts for the agent
- Remember that we deploy on Tuesdays and show me the proposed memory for review.
- Find the project structure decision in my memory and give me the relevant context.
- Add the project notes and documents to my local knowledge base.
How to install link
Platform CLI
claude mcp add link -- uvx link-mcpuvx runs the command named after the package; if the README names another one, use uvx --from link-mcp <command>
Platform CLI
codex mcp add link -- uvx link-mcpuvx runs the command named after the package; if the README names another one, use uvx --from link-mcp <command>
Config file
{
"mcpServers": {
"link": {
"command": "uvx",
"args": [
"link-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from link-mcp <command>
Config file
{
"servers": {
"link": {
"type": "stdio",
"command": "uvx",
"args": [
"link-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from link-mcp <command>
Platform CLI
gemini mcp add link uvx link-mcpuvx runs the command named after the package; if the README names another one, use uvx --from link-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about link
How do I install link in Claude Code?
Run claude mcp add link -- uvx link-mcp to add the link MCP server.
What does link do?
It stores agent memory in local Markdown files and returns relevant context through MCP or the CLI.
Do I approve memories before they are saved?
Yes. Agents submit proposed memories for your review, and automatic session hooks capture proposals rather than confirmed facts.
