Overseer Nvim MCP server

overseer-nvim-mcp

An MCP server that gives a coding agent the same control over overseer.nvim tasks that you have: list, tail, run, restart, stop, and dispose.

Why

Your agent's shell tool and your overseer task list are separate execution worlds. A dev server the agent starts in its own shell is invisible in the task list, can't be stopped from it, and orphans its process tree when the session ends. Tasks you start get proper teardown. This closes that gap: the agent's long-running commands become real overseer tasks.

Requirements

(tested against v2.1.0)

• Neovim with overseer.nvim

• Node >= 22
• An MCP client running inside a Neovim terminal buffer

Install

The server speaks stdio and is started by your MCP client. The command is always the same:

npx -y overseer-nvim-mcp

The client must run inside a Neovim terminal buffer; that is where the $NVIM socket it inherits comes from. Tools appear at the next session start, since MCP servers connect at startup. If the tools never appear, the usual cause is that $NVIM did not reach the server's environment: the server registers nothing without it, and some clients strip the environment they pass to servers.

Claude Code

claude mcp add overseer -- npx -y overseer-nvim-mcp

Codex CLI

codex mcp add overseer -- npx -y overseer-nvim-mcp

Then add one line to the generated block in ~/.codex/config.toml:

[mcp_servers.overseer]
command = "npx"
args = ["-y", "overseer-nvim-mcp"]
env_vars = ["NVIM"]

The env_vars line is required. Codex passes stdio servers a fixed whitelist of variables (HOME, PATH, TERM and the like), $NVIM is not on it, and without it the server registers no tools.

Codex also won't reach for the server on its own; see Getting your agent to actually use it.

Antigravity CLI

In ~/.gemini/config/mcp_config.json:

{
  "mcpServers": {
    "overseer": {
      "command": "npx",
      "args": ["-y", "overseer-nvim-mcp"]
    }
  }
}

That user-global file is the one to use: the CLI's non-interactive print mode (agy -p) loads MCP servers from it and from nowhere else; a workspace-level .agents/mcp_config.json is silently ignored there.

Antigravity also won't reach for the server on its own; see Getting your agent to actually use it.

Gemini CLI

gemini mcp add overseer npx -y overseer-nvim-mcp

Or in settings.json:

{
  "mcpServers": {
    "overseer": {
      "command": "npx",
      "args": ["-y", "overseer-nvim-mcp"]
    }
  }
}

opencode

In opencode.json:

{
  "mcp": {
    "overseer": {
      "type": "local",
      "command": ["npx", "-y", "overseer-nvim-mcp"]
    }
  }
}

mcphub.nvim (codecompanion.nvim, avante.nvim)

In mcphub's servers config:

Shortened. The full README is on GitHub.