Cowpin — Claude Code MCP server: features and setup
This MCP server for Claude Code connects an agent to a Cowpin library of bookmarks and notes. It searches saved page text, retrieves archived content, and drafts cited briefings.
MIT updated 2026-11-16
claude mcp add --env COWPIN_AGENT_API_KEY=<COWPIN_AGENT_API_KEY> --env COWPIN_API_URL=<COWPIN_API_URL> --transport stdio cowpin -- npx -y @cowpin/mcp-serverWhat Cowpin does
Cowpin gives an MCP client access to saved links and notes. An agent can add a URL or text, search page contents by meaning or keyword, retrieve an archived page, and build a topic briefing with citations. Other tools can read a live page without saving it, publish a link to the public feed, or comment on a feed item.
The package is a stdio bridge that forwards requests over HTTPS to Cowpin’s hosted MCP endpoint. It stores nothing locally. Running it requires npx and either COWPIN_AGENT_API_KEY or COWPIN_API_KEY; account-based access also requires a verified email. Saved items remain private unless published.
What it helps with
- save a link or text in a Cowpin library
- search saved pages by topic or keyword
- retrieve an archived page into the conversation
- create a cited briefing from saved material
- read a live page without adding it to the library
Example prompts for the agent
- Save this link to Cowpin with the tag
research. - Find my saved material about sorting and summarize the closest matches.
- Read this page as Markdown without saving it.
How to install Cowpin
Platform CLI
claude mcp add --env COWPIN_AGENT_API_KEY=<COWPIN_AGENT_API_KEY> --env COWPIN_API_URL=<COWPIN_API_URL> --transport stdio cowpin -- npx -y @cowpin/mcp-serverReplace <…> with your own values
Platform CLI
codex mcp add cowpin --env COWPIN_AGENT_API_KEY=<COWPIN_AGENT_API_KEY> --env COWPIN_API_URL=<COWPIN_API_URL> -- npx -y @cowpin/mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"cowpin": {
"command": "npx",
"args": [
"-y",
"@cowpin/mcp-server"
],
"env": {
"COWPIN_AGENT_API_KEY": "<COWPIN_AGENT_API_KEY>",
"COWPIN_API_URL": "<COWPIN_API_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"cowpin": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cowpin/mcp-server"
],
"env": {
"COWPIN_AGENT_API_KEY": "<COWPIN_AGENT_API_KEY>",
"COWPIN_API_URL": "<COWPIN_API_URL>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e COWPIN_AGENT_API_KEY=<COWPIN_AGENT_API_KEY> -e COWPIN_API_URL=<COWPIN_API_URL> cowpin npx -y @cowpin/mcp-serverReplace <…> with your own values
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 Cowpin
How do I install Cowpin in Claude Code?
Run claude mcp add mcp-server -e COWPIN_AGENT_API_KEY=<COWPIN_AGENT_API_KEY> -- npx -y @cowpin/mcp-server. Set the Cowpin key before starting the server.
What does Cowpin do?
It connects an agent to a Cowpin collection of bookmarks and notes. The agent can save items, search their contents, retrieve archived pages, and write cited briefings.
What does Cowpin need to run?
It requires npx and either COWPIN_AGENT_API_KEY or COWPIN_API_KEY. Account access requires a verified email; an autonomous agent can use a cw_agent_… key.