localize.dev

Docs / Agents / Gemini CLI

Localize an app with Gemini CLI

Add localize.dev to Gemini CLI's settings.json so Google's terminal agent can check, localize and translate your app's UI text.

How it works

Gemini CLI reads MCP servers from mcpServers in ~/.gemini/settings.json, or in .gemini/settings.json in the project to share them with the team.

Start with config. It tells the agent which languages the app ships, where the locale files are and what's in the glossary, so the code it writes uses your i18n library and your terms.

Set it up

First run npx localize-dev login in your terminal. It signs you in through the browser and saves a key, which the server reads, so the config below carries none.

  1. Add localize to the mcpServers in settings.json.
  2. Restart the agent, or reload its MCP servers, so it starts localize.
  3. Open your repository and ask it something like the prompt below.
~/.gemini/settings.json
{
  "mcpServers": {
    "localize": {
      "command": "npx",
      "args": ["-y", "localize-dev", "mcp"]
    }
  }
}

What you get

Where the server goes
~/.gemini/settings.json
Server
localize-dev mcp, started with npx on your machine
Key
The one npx localize-dev login saved
What init --agent adds
The AGENTS.md section with the instructions. Add the server by hand, as above.

Good to know

  • Gemini CLI reads GEMINI.md for project instructions. To use the section init --agent writes, point Gemini CLI's context file setting at AGENTS.md or copy the section into GEMINI.md.
  • /mcp in Gemini CLI lists the connected servers and their tools, the quickest way to see that localize started.

Try it

Ask something like this. The agent should call the config tool.

“Which languages does this app ship, and what's in its glossary?”

Keep it translated

Text the agent leaves hardcoded still gets caught: npx localize-dev check in CI fails a pull request that adds untranslated copy, and it needs no key.

npx localize-dev check

All agents and the tool reference are on the MCP server page.