nvim-editor-mcp

MCP server bridging tool calls to Neovim editor actions via RPC.

Exposes Neovim operations (open files, run Lua, diagnostics, quickfix, notifications) as Model Context Protocol tools, so AI agents can drive your editor.

Installation

Requires uv and Python ≥ 3.11.

uv tool install .

This puts nvim-editor-mcp on your PATH.

Related MCP server: @aetherall/mcp-nvim-tmux

Usage

nvim-editor-mcp auto-discovers the socket from the $NVIM env var, which is set when the mcp is started from nvim, e.g. through codecompanion

nvim-editor-mcp

# Explicit socket path
nvim-editor-mcp --socket /tmp/nvim.sock

The server starts in stdio MCP mode. If no socket is given and $NVIM is unset, it starts anyway and discovers the socket on the first tool call (via attach_nvim).

Tools

MCP client configuration

{
  "mcpServers": {
    "nvim-editor-mcp": {
      "command": "nvim-editor-mcp"
    }
  }
}

Development

Setup

uv sync

This creates a .venv and installs all runtime + dev dependencies.

Linting & formatting

uv run ruff check .
uv run ruff format .

Type checking

uv run ty check

Tests

uv run pytest

All checks (CI-style)

uv run ruff check . && uv run ruff format --check . && uv run ty check && uv run pytest

License

GPL-2.0