Is io.github.egoughnour/cowork-history safe to use?

io.github.egoughnour/cowork-history has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install io.github.egoughnour/cowork-history?

io.github.egoughnour/cowork-history can be installed by cloning its GitHub repository and following the setup instructions in the README.

What can io.github.egoughnour/cowork-history do?

io.github.egoughnour/cowork-history provides 10 tools: cowork_history_search, cowork_history_list, cowork_history_get, cowork_history_projects, cowork_history_stats and 5 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with io.github.egoughnour/cowork-history?

io.github.egoughnour/cowork-history is compatible with Claude Desktop, Cursor, Claude Code, and most MCP clients that support stdio transport. It uses stdio transport.

Is io.github.egoughnour/cowork-history actively maintained?

io.github.egoughnour/cowork-history is less actively maintained — last commit was 118 days ago. It has 1 GitHub stars.

io.github.egoughnour/cowork-history

Hybrid search for Cowork history: FTS, Spotlight, and semantic vectors

1 10 tools GitHub

No known CVEs

No license

Maintained

Last commit 118d ago

Untested

Transport: stdio

10 tools · ~590 tok

Grade B · 0.3% of 200K ctx

Edit this pageView history

Entertainment

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Untested on Claude Desktopstdio · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "io-github-egoughnour-cowork-history": {
      "command": "<see-readme>",
      "args": []
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-egoughnour-cowork-history)](https://mcppedia.org/s/io-github-egoughnour-cowork-history)

Read me

What io.github.egoughnour/cowork-history does

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.

Test This Server

No automated test available for this server. Check the GitHub README for setup instructions.

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

56/100across 5 weighted dimensions

How we score →

0255075100

−44

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

No package registry to scan.

Inventory

Tools (10)

Click any tool to inspect its schema.

~590 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.egoughnour/cowork-history safe to use?: io.github.egoughnour/cowork-history has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install io.github.egoughnour/cowork-history?: io.github.egoughnour/cowork-history can be installed by cloning its GitHub repository and following the setup instructions in the README.
What can io.github.egoughnour/cowork-history do?: io.github.egoughnour/cowork-history provides 10 tools: cowork_history_search, cowork_history_list, cowork_history_get, cowork_history_projects, cowork_history_stats and 5 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.egoughnour/cowork-history?: io.github.egoughnour/cowork-history is compatible with Claude Desktop, Cursor, Claude Code, and most MCP clients that support stdio transport. It uses stdio transport.
Is io.github.egoughnour/cowork-history actively maintained?: io.github.egoughnour/cowork-history is less actively maintained — last commit was 118 days ago. It has 1 GitHub stars.

Similar servers

Others in entertainment

View all →

com.mux/mcp94

The official MCP Server for the Mux API

179 7

ai.smithery/ChiR24-unreal_mcp_server92

A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…

653 11

Unity Mcp Server92

Unity MCP Server — 268 tools for AI-assisted game development. Connect Claude, Cursor, or any MCP client to Unity Editor & Unity Hub. Scene management, GameObjects, components, builds, profiling, Shader Graph, Amplify, terrain, physics, NavMesh, animation, MPPM multiplayer & more. Free & open source by AnkleBreaker Studio.

193 2

Strudel Mcp Server91

A Model Context Protocol (MCP) server that gives Claude direct control over Strudel.cc for AI-assisted music generation and live coding.

203 34

MCP Security Weekly

Get CVE alerts and security updates for io.github.egoughnour/cowork-history and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Edit this pageView history

Entertainment

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Untested on Claude Desktopstdio · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "io-github-egoughnour-cowork-history": {
      "command": "<see-readme>",
      "args": []
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-egoughnour-cowork-history)](https://mcppedia.org/s/io-github-egoughnour-cowork-history)

Read me

What io.github.egoughnour/cowork-history does

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.

Test This Server

No automated test available for this server. Check the GitHub README for setup instructions.

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

Option 4: Manual Configuration

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "cowork-history": {
      "command": "uvx",
      "args": ["cowork-history"],
      "env": {
        "OLLAMA_URL": "http://localhost:11434",
        "EMBEDDING_MODEL": "nomic-embed-text"
      }
    }
  }
}

Quick Start

Once installed, Claude can search your conversation history:

"What did we discuss about authentication last week?"
"Find the conversation where we debugged the payment webhook"
"Show me my conversations in the my-project folder"

Available Tools

Search & Browse

Tool	Description
`cowork_history_search`	Search conversations using hybrid search (FTS + Spotlight + vector)
`cowork_history_list`	List recent conversations, optionally filtered by project
`cowork_history_get`	Get full content of a specific conversation by session ID
`cowork_history_projects`	List all projects with conversation history
`cowork_history_stats`	Get statistics and search capability status
`cowork_history_reindex`	Rebuild index and optionally generate embeddings

Ollama Setup (for Vector Search)

Tool	Description
`history_system_check`	Check system requirements for Ollama
`history_setup_ollama`	Install Ollama via Homebrew (macOS)
`history_setup_ollama_direct`	Install Ollama via direct download (no Homebrew)
`history_ollama_status`	Check Ollama status and embedding model availability

Search Modes

The cowork_history_search tool supports multiple search modes:

Mode	Description
`auto` (default)	Uses all available methods, best results
`fts`	Full-text search only (fastest)
`spotlight`	macOS Spotlight only
`vector`	Semantic similarity only (requires Ollama)
`hybrid`	Explicit combination with ranking

Search Examples

"authentication bug"           → finds conversations with both words
"how to deploy"                → semantic search finds related discussions
"\"exact phrase\""             → exact phrase matching
project:"my-app" "database"    → filter by project

Enabling Vector Search

Vector search provides semantic similarity matching (finding related concepts even without exact keywords). It requires Ollama with an embedding model.

Quick Setup

Ask Claude to set it up for you:

"Set up Ollama for vector search"

Or manually:

# Install Ollama (macOS)
brew install ollama

# Start Ollama service
brew services start ollama

# Pull the embedding model
ollama pull nomic-embed-text

Then generate embeddings:

"Rebuild the history index with embeddings"

How I

... View full README on GitHub

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

56/100across 5 weighted dimensions

How we score →

0255075100

−44

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

No package registry to scan.

Inventory

Tools (10)

Click any tool to inspect its schema.

~590 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.egoughnour/cowork-history safe to use?: io.github.egoughnour/cowork-history has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install io.github.egoughnour/cowork-history?: io.github.egoughnour/cowork-history can be installed by cloning its GitHub repository and following the setup instructions in the README.
What can io.github.egoughnour/cowork-history do?: io.github.egoughnour/cowork-history provides 10 tools: cowork_history_search, cowork_history_list, cowork_history_get, cowork_history_projects, cowork_history_stats and 5 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.egoughnour/cowork-history?: io.github.egoughnour/cowork-history is compatible with Claude Desktop, Cursor, Claude Code, and most MCP clients that support stdio transport. It uses stdio transport.
Is io.github.egoughnour/cowork-history actively maintained?: io.github.egoughnour/cowork-history is less actively maintained — last commit was 118 days ago. It has 1 GitHub stars.