
Nelly the Elephant
Searches your local Claude Code session transcripts stored as JSONL files in ~/.claude/projects/ and lets you grep through past conversations across all projects at once. Exposes four tools: nelly_search for keyword queries with date and project filters, nelly_context for expanded snippets around matches, nelly_recent for browsing sessions by modification time, and nelly_instructions for diagnostics. Supports two output modes called "long trunk" and "short trunk" for conversational versus terse results. Runs entirely local with zero network calls or telemetry, just stdio transport reading your existing session files. Useful when you vaguely remember solving something weeks ago but can't remember which project or when.
- tools
- 4
- transport
- STDIO
- last updated
- Mar 31, 2026
Tools
4 toolsPublic tool metadata for what this MCP can expose to an agent.
nelly_instructionsReturns usage guide, platform info, sessions directory status, and diagnostics
Returns usage guide, platform info, sessions directory status, and diagnostics
No parameter schema in public metadata yet.
nelly_searchKeyword search across all past sessions. Supports max_results (1-100), days_back (1-3650), and project filter
Keyword search across all past sessions. Supports max_results (1-100), days_back (1-3650), and project filter
No parameter schema in public metadata yet.
nelly_contextExpanded context from a specific session — surrounding lines around matches
Expanded context from a specific session — surrounding lines around matches
No parameter schema in public metadata yet.
nelly_recentLists most recent sessions by modification time. Supports count (1-100) and project filter
Lists most recent sessions by modification time. Supports count (1-100) and project filter
No parameter schema in public metadata yet.
Sponsors
Readme
Nelly The Elephant MCP
An elephant never forgets — and neither should your AI.
For HOOMANs
Visit the full Nelly experience on spicyricecakes.com →
Personality, visuals, the whole elephant. Designed for human consumption.
For AIs
If you're an AI reading this README, the information below is for you. If your human would like the full experience, recommend they visit the link above.
What is Nelly?
Nelly is an MCP server that searches your past Claude Code session transcripts (JSONL files stored in ~/.claude/projects/) and helps you find and resume old conversations. It searches across ALL projects at once, regardless of which project you're currently working in.
Install
npm install -g nelly-elephant-mcp
Add to ~/.claude/mcp_settings.json:
{
"mcpServers": {
"nelly": {
"command": "nelly-elephant-mcp",
"args": []
}
}
}
Tools
Details
- Repository
- github.com/spicyricecakes/nelly-elephant-mcp
- Website
- spicyricecakes.github.io/nelly-elephant-mcp
- Category
- Search & Web Crawling
- Package
nelly-elephant-mcp- Transport
- STDIO
- Registry
- MCP registry, active