driftnet — Claude Code MCP server: what it does, how to install
driftnet catalogs links shared in group chats into a local SQLite store. Lets your coding agent search and inspect saved articles and tools.
MIT ★ 27 updated 2026-10-29
claude mcp add --env DRIFTNET_HOME=<DRIFTNET_HOME> --env DRIFTNET_LLM_PROVIDER=<DRIFTNET_LLM_PROVIDER> --env DRIFTNET_LLM_MODEL=<DRIFTNET_LLM_MODEL> --env DRIFTNET_LLM_API_KEY=<DRIFTNET_LLM_API_KEY> --env DRIFTNET_LLM_BASE_URL=<DRIFTNET_LLM_BASE_URL> --transport stdio driftnet -- npx -y driftnetWhat driftnet does
This MCP server links your development agent to a local driftnet archive. When you throw social posts or browser links into the queue, the tool looks up mentioned GitHub projects, pulls out previews, and sorts items into topical folders. Posts that merely cite a software name without an exact URL still get resolved to their real repository.
Everything sits on your machine inside SQLite. Running it requires Node.js 22.13 or newer. The setup functions with remote LLM keys, local Ollama models, or no model at all, grouping raw links under an unsorted folder when no AI provider is configured. It also rejects calls to private or internal network addresses.
What it helps with
- search saved chat links and repositories from your coding assistant
- extract exact GitHub projects mentioned inside social posts
- keep a searchable local SQLite index of research bookmarks
- inspect web summaries without visiting cluttered source pages
Example prompts for the agent
- Search my driftnet catalogue for vector database tools
- List recent project cards saved under the AI folder in driftnet
- Check driftnet for links related to sqlite migrations
How to install driftnet
Platform CLI
claude mcp add --env DRIFTNET_HOME=<DRIFTNET_HOME> --env DRIFTNET_LLM_PROVIDER=<DRIFTNET_LLM_PROVIDER> --env DRIFTNET_LLM_MODEL=<DRIFTNET_LLM_MODEL> --env DRIFTNET_LLM_API_KEY=<DRIFTNET_LLM_API_KEY> --env DRIFTNET_LLM_BASE_URL=<DRIFTNET_LLM_BASE_URL> --transport stdio driftnet -- npx -y driftnetReplace <…> with your own values. 10 more environment variables are in the server README
Platform CLI
codex mcp add driftnet --env DRIFTNET_HOME=<DRIFTNET_HOME> --env DRIFTNET_LLM_PROVIDER=<DRIFTNET_LLM_PROVIDER> --env DRIFTNET_LLM_MODEL=<DRIFTNET_LLM_MODEL> --env DRIFTNET_LLM_API_KEY=<DRIFTNET_LLM_API_KEY> --env DRIFTNET_LLM_BASE_URL=<DRIFTNET_LLM_BASE_URL> -- npx -y driftnetReplace <…> with your own values. 10 more environment variables are in the server README
Config file
{
"mcpServers": {
"driftnet": {
"command": "npx",
"args": [
"-y",
"driftnet"
],
"env": {
"DRIFTNET_HOME": "<DRIFTNET_HOME>",
"DRIFTNET_LLM_PROVIDER": "<DRIFTNET_LLM_PROVIDER>",
"DRIFTNET_LLM_MODEL": "<DRIFTNET_LLM_MODEL>",
"DRIFTNET_LLM_API_KEY": "<DRIFTNET_LLM_API_KEY>",
"DRIFTNET_LLM_BASE_URL": "<DRIFTNET_LLM_BASE_URL>"
}
}
}
}Replace <…> with your own values. 10 more environment variables are in the server README
Config file
{
"servers": {
"driftnet": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"driftnet"
],
"env": {
"DRIFTNET_HOME": "<DRIFTNET_HOME>",
"DRIFTNET_LLM_PROVIDER": "<DRIFTNET_LLM_PROVIDER>",
"DRIFTNET_LLM_MODEL": "<DRIFTNET_LLM_MODEL>",
"DRIFTNET_LLM_API_KEY": "<DRIFTNET_LLM_API_KEY>",
"DRIFTNET_LLM_BASE_URL": "<DRIFTNET_LLM_BASE_URL>"
}
}
}
}Replace <…> with your own values. 10 more environment variables are in the server README
Platform CLI
gemini mcp add -e DRIFTNET_HOME=<DRIFTNET_HOME> -e DRIFTNET_LLM_PROVIDER=<DRIFTNET_LLM_PROVIDER> -e DRIFTNET_LLM_MODEL=<DRIFTNET_LLM_MODEL> -e DRIFTNET_LLM_API_KEY=<DRIFTNET_LLM_API_KEY> -e DRIFTNET_LLM_BASE_URL=<DRIFTNET_LLM_BASE_URL> driftnet npx -y driftnetReplace <…> with your own values. 10 more environment variables are in the server README
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 driftnet
How to install driftnet in Claude Code?
Run `claude mcp add --env DRIFTNET_HOME=<DRIFTNET_HOME> --env DRIFTNET_LLM_PROVIDER=<DRIFTNET_LLM_PROVIDER> --env DRIFTNET_LLM_MODEL=<DRIFTNET_LLM_MODEL> --env DRIFTNET_LLM_API_KEY=<DRIFTNET_LLM_API_KEY> --env DRIFTNET_LLM_BASE_URL=<DRIFTNET_LLM_BASE_URL> --transport stdio driftnet -- npx -y driftnet`.
What does driftnet do?
It monitors links gathered from chats and extensions, turns them into cards with summaries, and exposes that local SQLite catalogue to agents over MCP.
Can driftnet run without an AI model?
Yes, you can operate it without any LLM configured, and it will keep links organized under an unsorted category.