Gemini CLI Neovim

v1.0.0Developer Toolsstable

Neovim integration for the Gemini CLI. Bridges the editor with Gemini's IDE Mode via a lightweight MCP server

aigeminigemini-cligoogle-geminimcp
Share:
11
Stars
0
Downloads
0
Weekly
0/5

What is Gemini CLI Neovim?

Gemini CLI Neovim is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to neovim integration for the gemini cli. bridges the editor with gemini's ide mode via a lightweight mcp server

Neovim integration for the Gemini CLI. Bridges the editor with Gemini's IDE Mode via a lightweight MCP server

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Neovim integration for the Gemini CLI. Bridges the editor wi

Use Cases

Neovim integration with Gemini CLI
IDE-mode editing assistance
vaijab

Maintainer

LicenseMIT
Languagelua
Versionv1.0.0
UpdatedMay 8, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx gemini-cli-nvim

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Gemini CLI Neovim

gemini-cli.nvim is a Neovim plugin that implements the Model Context Protocol to bridge the Gemini CLI agent with Neovim's LSP and Tree-sitter engines, giving the AI semantic access to your codebase through go-to-definition, find-references, diagnostics, symbol search, and file outline tools without leaving your editor.

Prerequisites

  • Neovim >= 0.10 installed
  • Go >= 1.23 installed (required to build the internal bridge server)
  • Gemini CLI installed globally: npm install -g @google/gemini-cli
  • A Neovim plugin manager such as lazy.nvim
  • LSP and Tree-sitter configured in Neovim for the languages you work with
1

Install the Plugin via lazy.nvim

Add the plugin spec to your lazy.nvim configuration. The build step ':GeminiBuild' compiles the internal Go bridge server that manages the MCP connection between Neovim and the Gemini CLI agent.

-- In your lazy.nvim plugin list
{
    "vaijab/gemini-cli.nvim",
    build = ":GeminiBuild",
    opts = {},
}
2

Build the Go Bridge Server

If you skipped the automatic build step or need to rebuild, run the GeminiBuild command from inside Neovim. This compiles the Go server that handles the MCP protocol between Neovim and Gemini CLI.

:GeminiBuild
3

Call the Setup Function

Initialize the plugin in your Neovim config. The default setup with empty opts is sufficient for most users. Enable debug logging if you need to trace MCP tool calls.

require("gemini").setup({
    -- Enable verbose logging for debugging MCP connections
    debug = false,
})
4

Add Diff Workflow Keymaps

The plugin provides GeminiDiffAccept and GeminiDiffDeny commands for the native diff workflow but does not set default keymaps. Add these to your Neovim config to accept or reject AI-proposed code changes.

vim.keymap.set("n", "<leader>gy", "<cmd>GeminiDiffAccept<cr>", { desc = "Gemini Accept Diff" })
vim.keymap.set("n", "<leader>gn", "<cmd>GeminiDiffDeny<cr>",   { desc = "Gemini Reject Diff" })
5

Launch the Gemini CLI Agent

Open Neovim with your project, then run the 'gemini' CLI command in a terminal. The plugin automatically shares your open files, cursor position, and visual selections with the agent. No additional MCP configuration is required — the plugin manages connection details automatically.

# In your terminal (outside Neovim, or in a Neovim terminal split)
gemini

Gemini CLI Neovim Examples

Client configuration

lazy.nvim plugin spec with the required build step and optional sidekick.nvim for a sidebar experience.

{
  "vaijab/gemini-cli.nvim",
  build = ":GeminiBuild",
  dependencies = {
    -- Optional: run Gemini in a sidebar within Neovim
    "folke/sidekick.nvim",
  },
  opts = {
    debug = false,
  },
}

Prompts to try

Queries to send to the Gemini CLI agent once it is connected to Neovim via the MCP plugin.

- "Find all references to the UserService class and summarise where it is used."
- "Go to the definition of the parseConfig function and explain what it does."
- "Show me the file outline for the current file."
- "What LSP diagnostics are failing in this workspace right now?"
- "Read the full implementation of the AuthMiddleware class and suggest security improvements."

Troubleshooting Gemini CLI Neovim

GeminiBuild fails with 'go: command not found'

The Go bridge server requires Go 1.23 or newer. Install Go from https://go.dev/dl/ and ensure the 'go' binary is on your PATH before running :GeminiBuild inside Neovim.

Gemini CLI connects but MCP tools return empty results

The tools rely on Neovim's LSP and Tree-sitter being active for the current buffer. Ensure your LSP server has attached (run :LspInfo to check) and Tree-sitter parsers are installed for the language (run :TSInstall <language>). Open a source file before starting the Gemini CLI session.

The plugin loads but 'gemini' CLI cannot find the Neovim MCP server

The plugin automatically manages MCP connection details per Neovim instance. Make sure you launch 'gemini' from a terminal where the same Neovim instance is already running. Starting Gemini before opening Neovim will not work.

Frequently Asked Questions about Gemini CLI Neovim

What is Gemini CLI Neovim?

Gemini CLI Neovim is a Model Context Protocol (MCP) server that neovim integration for the gemini cli. bridges the editor with gemini's ide mode via a lightweight mcp server It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Gemini CLI Neovim?

Follow the installation instructions on the Gemini CLI Neovim GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Gemini CLI Neovim?

Gemini CLI Neovim works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Gemini CLI Neovim free to use?

Yes, Gemini CLI Neovim is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "gemini-cli-nvim": { "command": "npx", "args": ["-y", "gemini-cli-nvim"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Gemini CLI Neovim?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides