
nvim-mcp
by paulburgess1357
Connects AI agents to running Neovim sessions via msgpack-RPC for real-time buffer editing and command execution.
What it does
nvim-mcp is an MCP server that bridges AI agents directly to a running Neovim instance. Unlike traditional plugins, it leverages Neovim's native msgpack-RPC socket, allowing agents to perceive the editor's state and interact with it as a human would.
Tools
- Buffer Access: Read current buffers, working directories, and cursor context.
- In-Memory Editing: Perform find-and-replace or full rewrites with immediate feedback and undo support.
- Command Execution: Run any Vim command (e.g.,
:w,:vsplit, macros). - Keystroke Injection: Navigate the editor or trigger complex mappings.
- LSP Integration: Query diagnostics (errors/warnings) across the session.
- Visual Annotations: Add highlights and virtual text without modifying buffer content.
Installation
Install via uv (recommended):
curl -LsSf https://astral.sh/uv/install.sh | sh
Add to your client config (e.g., Cursor .cursor/mcp.json):
{
"mcpServers": {
"nvim-mcp": {
"command": "uvx",
"args": ["nvim-mcp"]
}
}
}
Supported hosts
Supported on Cursor, Claude Code, and Codex.
Quick install
uvx nvim-mcpInformation
- Pricing
- free
- Published
- 5/20/2026
- stars






