This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Lima in AI (MCP)

Starting with Lima v2.0, Lima provides Model Context Protocol (MCP) tools for reading, writing, and executing local files using a VM sandbox.

1 - Gemini

⚡ RequirementLima >= 2.0

This page describes how to use Lima as an sandbox for Google Gemini CLI.

Configuration

  1. Run the default Lima instance:
limactl start default
  1. Create .gemini/extensions/lima/gemini-extension.json as follows:
{
  "name": "lima",
  "version": "2.0.0",
  "mcpServers": {
    "lima": {
      "command": "limactl",
      "args": [
        "mcp",
        "serve",
        "default"
      ]
    }
  }
}
  1. Modify .gemini/settings.json so as to disable Gemini CLI’s built-in tools except ones that do not relate to local command execution and file I/O:
{
  "coreTools": ["WebFetchTool", "WebSearchTool", "MemoryTool"]
}

Usage

Just run gemini.

The project directory must be mounted inside the VM. i.e., typically it must be under the home directory.