ivygrep
Local code search and token-budgeted context packs for coding agents
- Pricing
- Free
- Platforms
- CLI, macOS, Linux
- Runs
- Locally
- Version
- 1.3.6
- Listing updated
- 3 days ago
About ivygrep
ivygrep is a free MCP server for developer tools. It runs locally on your machine and is started by your AI client.
ivygrep indexes a repository on your machine and answers questions by intent, such as where a token is rotated, then returns ranked file paths, line numbers and previews. Its context-pack mode goes further: given a task and a token budget, it assembles definitions, callers, dependencies, tests, config and docs, labels why each item was selected, and trims the Markdown to the budget. It does not generate an answer or modify files.
The since option takes a Git ref, finds its merge base with HEAD, and includes commits on the current branch plus staged, unstaged and untracked files. Files, queries and embeddings stay local; the default model downloads pinned assets on first use and runs on CPU, with Metal or CUDA builds for optional transformer profiles.
The MCP server runs over stdio as ig --mcp, shipped as a checksum-pinned bundle for macOS, Linux and Windows.
Install
Run in a terminal
claude mcp add ivygrep -- npx -y https://github.com/bvolpato/ivygrep/releases/download/v1.3.6/ivygrep-mcp-v1.3.6.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"ivygrep": {
"command": "npx",
"args": [
"-y",
"https://github.com/bvolpato/ivygrep/releases/download/v1.3.6/ivygrep-mcp-v1.3.6.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ivygrep": {
"command": "npx",
"args": [
"-y",
"https://github.com/bvolpato/ivygrep/releases/download/v1.3.6/ivygrep-mcp-v1.3.6.mcpb"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"ivygrep": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/bvolpato/ivygrep/releases/download/v1.3.6/ivygrep-mcp-v1.3.6.mcpb"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"ivygrep": {
"command": "npx",
"args": [
"-y",
"https://github.com/bvolpato/ivygrep/releases/download/v1.3.6/ivygrep-mcp-v1.3.6.mcpb"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"ivygrep": {
"command": "npx",
"args": [
"-y",
"https://github.com/bvolpato/ivygrep/releases/download/v1.3.6/ivygrep-mcp-v1.3.6.mcpb"
]
}
}
}Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- ig_search
- Searches code or builds a context pack.
- ig_status
- Reports index state.
What it does
- Intent search
- Find code by what it does, hybrid semantic and lexical.
- Context packs
- Budgeted bundles of related code with reasons for each item.
- Branch-aware context
- Includes committed, staged and untracked changes since a ref.
- Local indexing
- A daemon watches the repo and updates the index incrementally.
- Pinned bundle
- Cross-platform MCP bundle with a pinned SHA-256.
- Missing-file handling
- Search excludes files confirmed deleted from the workspace.
Good for
- Gather context for a bug fix within a token budget
- Find where authentication is handled
- Feed an agent only the code relevant to a branch
- Search code and notes without sending them off-machine
Pricing
Free
No price listed; installs via Homebrew, WinGet or release installer
Prices change. Check bvolpato.github.io before you buy.
ivygrep FAQ
Does my code leave the machine?
The README says files and queries stay on your machine, apart from the first-use model download.
How do I start the server?
Run ig --mcp over stdio, or install the MCP bundle from a registry client.
Which platforms?
macOS, Linux and Windows.
Does it write code?
No. Context packs do not generate answers or change files.
Is ivygrep free?
Yes. ivygrep is free to use.
How do I add ivygrep to Claude Code?
Run this command in your terminal: claude mcp add ivygrep -- npx -y https://github.com/bvolpato/ivygrep/releases/download/v1.3.6/ivygrep-mcp-v1.3.6.mcpb
What are the best alternatives to ivygrep?
The closest alternatives to ivygrep are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to ivygrep

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools