grepai-mcp-claude

Configure GrepAI as an MCP server to enable semantic code search in Claude Code.

Updated May 12, 2026
One-click install
npx skills add https://github.com/eduardtomasek/codex-dev-stack --skill grepai-mcp-claude-eduardtomasek
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grepai-mcp-claude
Source: https://github.com/eduardtomasek/codex-dev-stack/tree/main/skills/.agents/grepai-mcp-claude
Command: npx skills add https://github.com/eduardtomasek/codex-dev-stack --skill grepai-mcp-claude-eduardtomasek

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Connecting Claude Code to a semantic code search engine requires manual MCP server configuration, correct working directory setup, and a pre-built code index, which is error-prone without clear guidance. ## Core Features & Use Cases - One-Command MCP Setup: Register GrepAI with Claude Code using claude mcp add grepai -- grepai mcp-serve or manual JSON configuration in ~/.claude/mcp.json. - Semantic Search Tools: Exposes grepai_search, grepai_trace_callers, grepai_trace_callees, grepai_trace_graph, and grepai_index_status tools to Claude Code with compact JSON output that reduces token usage by roughly 80%. - Multi-Project Support: Configure multiple MCP server entries with distinct working directories or use GrepAI workspaces to search across several codebases. - Use Case: A developer working in a large Go codebase asks Claude Code to find authentication logic; Claude calls grepai_search and returns ranked file locations with line ranges instead of scanning files manually. ## Quick Start Ask the assistant to add GrepAI to Claude Code by running the MCP registration command and then verify the connection by requesting a semantic search of the current project.

Frequently Asked Questions about grepai-mcp-claude

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add GrepAI to Claude Code as an MCP server?▼

Run `claude mcp add grepai -- grepai mcp-serve` to register GrepAI with Claude Code in one command. Alternatively, add a grepai entry with command `grepai` and args `["mcp-serve"]` to `~/.claude/mcp.json` manually.

What tools does GrepAI expose to Claude Code via MCP?▼

GrepAI provides five MCP tools: grepai_search for semantic code search, grepai_trace_callers and grepai_trace_callees for call tracing, grepai_trace_graph for call graphs, and grepai_index_status for index health checks.

Why does GrepAI search return no results in Claude Code?▼

Empty results usually mean the project has not been indexed. Run `grepai watch` first, confirm a `.grepai/` directory exists in the working directory, and verify the index with `grepai status`.

Can I use GrepAI MCP with multiple projects in Claude Code?▼

Yes. Either define multiple MCP server entries each with its own `cwd` pointing to a different project, or create a GrepAI workspace containing several projects and pass `--workspace` to `grepai mcp-serve`.

Why won't the GrepAI MCP server start?▼

The server fails to start when Ollama is not running or the config is invalid. Check Ollama with `curl http://localhost:11434/api/tags`, inspect `.grepai/config.yaml`, and run `grepai mcp-serve` manually to see error output.