paulburgess1357/nvim-mcp
View on GitHub ↗MCP server that connects AI agents to your running Neovim instance via msgpack-RPC — no plugins required.
60 ★6 forksPythonUpdated 29d ago
What you need to know
An MCP server that gives AI agents first-class access to a running Neovim session over the native msgpack-RPC socket, with no plugins required.
Install
uvx nvim-mcp Or nix run github:paulburgess1357/nvim-mcp
Usage
- •Register nvim-mcp in your client config and add agent rules
- •Ask the agent to inspect buffers, edit in memory, run Vim commands, or query diagnostics
- •Neovim auto-discovery connects to running instances
Key features
- ✓See editor mode, buffers, window layout, cursor, folds, selections, marks, and diagnostics
- ✓In-memory buffer edits with undo support, nothing touches disk until save
- ✓Run any Vim command and send keystrokes
- ✓LSP diagnostics across one buffer or the whole session
- ✓Highlights and virtual text annotations
- ✓Multiple Neovim instance support
Best for
Neovim users on Linux who want AI agents to edit and navigate their editor directly.
Caveats
- ⚠Linux only
- ⚠Requires Python 3.10+ and Neovim 0.11+
- ⚠Treat agent edits carefully; work in a version-controlled directory
Platforms: LinuxClients: Cursor · Claude Code · Codex · OpenCode · Any MCP-compatible client
Reviewed 2026-08-11
Topics
aiartificial-intelligenceclaudeclaude-codecodexcursorlarge-language-modelllmmcpmcp-servermodel-context-protocolmsgpack-rpcneovimneovim-confignvimopenaitext-editorvim
- Stars
- 60★
- Forks
- 6
- Language
- Python
- License
- MIT
- Created
- 2026-04-05
- Last push
- 2026-08-06