Cowork History
Indexes your local Claude conversation history from ~/.claude/ and lets you search it three ways: SQLite FTS5 with BM25 ranking, macOS Spotlight via mdfind, and optional semantic vector search through Ollama embeddings. Exposes tools to search conversations by keyword or meaning, list recent chats filtered by project, retrieve full session content, and rebuild the index. Includes helper tools to install and configure Ollama if you want the vector search layer. The indexer runs incrementally and caches filesystem paths it discovers. Reach for this when you need to recall what you discussed in previous Claude sessions without manually digging through chat folders.
- GitHub stars
- 1
- tools
- 10
- transport
- STDIO
- env vars
- 2
- last updated
- Jan 30, 2026
Tools
10 toolsPublic tool metadata for what this MCP can expose to an agent.
cowork_history_searchSearch conversations using hybrid search (FTS + Spotlight + vector)
Search conversations using hybrid search (FTS + Spotlight + vector)
No parameter schema in public metadata yet.
cowork_history_listList recent conversations, optionally filtered by project
List recent conversations, optionally filtered by project
No parameter schema in public metadata yet.
cowork_history_getGet full content of a specific conversation by session ID
Get full content of a specific conversation by session ID
No parameter schema in public metadata yet.
cowork_history_projectsList all projects with conversation history
List all projects with conversation history
No parameter schema in public metadata yet.
cowork_history_statsGet statistics and search capability status
Get statistics and search capability status
No parameter schema in public metadata yet.
cowork_history_reindexRebuild index and optionally generate embeddings
Rebuild index and optionally generate embeddings
No parameter schema in public metadata yet.
history_system_checkCheck system requirements for Ollama
Check system requirements for Ollama
No parameter schema in public metadata yet.
history_setup_ollamaInstall Ollama via Homebrew (macOS)
Install Ollama via Homebrew (macOS)
No parameter schema in public metadata yet.
history_setup_ollama_directInstall Ollama via direct download (no Homebrew)
Install Ollama via direct download (no Homebrew)
No parameter schema in public metadata yet.
history_ollama_statusCheck Ollama status and embedding model availability
Check Ollama status and embedding model availability
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
OLLAMA_URLURL for Ollama server (default: http://localhost:11434)
EMBEDDING_MODELOllama embedding model (default: nomic-embed-text)
Readme
Cowork History MCP
An MCP (Model Context Protocol) server for searching and browsing your Claude conversation history stored in ~/.claude/. Works with both Claude Code and Cowork conversations.
Features
- Hybrid Search - Combines multiple search methods for best results:
- SQLite FTS5 - Fast full-text search with BM25 ranking
- macOS Spotlight - Leverages system content indexing via
mdfind - Vector Embeddings - Semantic similarity search (optional, requires Ollama)
- Smart Path Reconstruction - Recovers actual filesystem paths via probing (not heuristic guessing)
- Persistent Index - SQLite database with incremental updates for fast queries
- Ollama Setup Tools - Automated installation and configuration for embeddings
Installation
Option 1: Claude Desktop (One-Click Install)
Download cowork-history.mcpb from the latest release and double-click to install.
Option 2: Via uvx (Recommended for CLI)
uvx cowork-history
Option 3: Via pip
pip install cowork-history
Details
- Repository
- github.com/egoughnour/cowork-history
- Category
- Search & Web Crawling
- Package
cowork-history- Transport
- STDIO
- Registry
- MCP registry, active
More from egoughnour
Related Search & Web Crawling MCP servers
View all
Generectgenerect/generect_mcpB2B lead and company data for AI agents: free search, pay only for emails, phones, profiles.1stars
Ailist Mcphifriendbot/ailist-mcpMCP server for AiList — search and discover Ai projects from Claude Code1stars
Cobroyadan1d/mercadopago-toolMercado Pago payments for AI agents: payment links, search, refunds, merchant info.0stars
UK Supermarketsjbeshir/mcp-serversSearch and compare grocery prices across UK supermarkets with product details.0stars
TOP GUN GEO-Lensspacemandomains/top_gun_mcp_serverBrand visibility auditing across LLMs, AI search, and answer engines with GEO reports and scores.1stars
Doctree Mcpjoesaby/doctree-mcpBM25 search + tree navigation over markdown docs for AI agents. No embeddings, no LLM calls.1stars