How do I use Greply MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Greply MCP Server search for 'TODO' in src/ with 2 lines of context before and after" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

greply MCP Server

An MCP server that wraps the greply CLI (Node wrapper for the greppy search tool).
This allows you to use greply directly from an MCP-compatible client such as the Gemini CLI.

Features

greply.search — run greply with query, before/after context, and flags.
greply.help — print greply usage text.

Related MCP server: metasearch-mcp

Requirements

Node.js 20 or newer (22 LTS recommended)
npm or pnpm for dependency installation
greply CLI available on PATH, or specify greply_CMD env var

Installation

Clone and install dependencies:

git clone https://github.com/your-org/greply-mcp-server.git cd greply-mcp-server # Make sure Node version is >= 20 node -v # If needed: # curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash # source ~/.nvm/nvm.sh # nvm install 22 && nvm use 22 npm install

Usage

Run the server directly:

node server.mjs

Or with npm:

npm start

Gemini CLI Configuration

Add this to your ~/.gemini/settings.json:

{ "mcpServers": { "greply": { "command": "node", "args": ["/absolute/path/to/greply-mcp-server/server.mjs"], "env": { "greply_CMD": "/usr/local/bin/greppy" } } } }

greply_CMD is optional — only set it if the server cannot find greply automatically.
Use an absolute path for server.mjs.

Tools

`greply.search`

Search files or directories with the given query and optional flags.

Input schema:

Field	Type	Description
`query`	string	Search term (required)
`target`	string	File or directory (default `"."`)
`before`	integer	Lines of context before match (`-B`)
`after`	integer	Lines of context after match (`-A`)
`recursive`	boolean	Recurse directories (`-R`)
`wholeWord`	boolean	Match whole words (`-w`)
`matchCase`	boolean	Case-sensitive match (`-c`)
`fixedStrings`	boolean	Fixed-string match (`-F`)
`suppressErrors`	boolean	Return stdout/stderr on non-zero exit

`greply.help`

Display greply usage information.

Install Server

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

How are these scores calculated?

Resources

Need Help?

Report Issue

Related Servers

Greply MCP Server

greply MCP Server

Features

Requirements

Installation

Usage

Gemini CLI Configuration

Tools

`greply.search`

`greply.help`

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API