Cowork History MCP Server
by egoughnourio.github.egoughnour/cowork-historyv4.0.3
Hybrid search for Cowork history: FTS, Spotlight, and semantic vectors
context tax
queued
security
queued
cold start
queued
freshness
Stale8mo ago
Install Cowork History MCP server
Install in Claude Code
claude mcp add cowork-history -- uvx cowork-historyInstall in Cursor
{
"mcpServers": {
"cowork-history": {
"command": "uvx",
"args": [
"cowork-history"
]
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"cowork-history": {
"command": "uvx",
"args": [
"cowork-history"
]
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"cowork-history": {
"type": "stdio",
"command": "uvx",
"args": [
"cowork-history"
]
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"cowork-history": {
"command": "uvx",
"args": [
"cowork-history"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| OLLAMA_URL | — | — | URL for Ollama server (default: http://localhost:11434) |
| EMBEDDING_MODEL | — | — | Ollama embedding model (default: nomic-embed-text) |
Freshness
Stale — last maintenance signal 8mo ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-01-30 · 8mo ago · GitHub
Latest release
2026-01-30 · 8mo ago · GitHub · v4.0.3
Package published
no data · npm/PyPI
Registry entry updated
2026-01-30 · 8mo ago · official registry · v4.0.3
FAQ
›How do I install the Cowork History MCP server in Claude Code?
Run: claude mcp add cowork-history -- uvx cowork-history. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Cowork History require an API key?
No required environment variables are declared in its published metadata.
›Can I use Cowork History as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Cowork History in the official MCP registry?
Yes, as io.github.egoughnour/cowork-history.