Skip to content
MCP server

ivygrep

Local code search and token-budgeted context packs for coding agents

Runs locallyStatus and history
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.mcpb

Add 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"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

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"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools