# Babelize

> Babelize is a freemium MCP server for developer tools. Localize apps from your coding agent: analyze, translate, check and review i18n locally. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://docs.babelize.co/integrations/mcp-server
- **MCP Registry name:** io.github.babelize/mcp
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

Four local workflow tools run the same engine as the `npx babelize translate` command and write into your working tree, so the result is a normal git diff. The loop an agent follows is analyze, translate, check or review, fix, repeat. React, Next.js, Django and static HTML are supported, with Vue and React Native in beta.

Translation refuses to run on a dirty git tree unless you pass dryRun or force, and a lockfile means reruns only translate new or changed strings. The QA tools catch missing or empty keys, lost placeholders, invalid ICU messages, wrong plural forms and glossary violations; review limits the same checks to locale entries changed in the diff. A glossary lives in `.babelize/config.json`.

You can bring your own Anthropic, OpenAI, Gemini, Groq or OpenRouter key, or use a Babelize API key for hosted translation. Keys come from the server's environment and are never tool arguments. The server also carries cloud project tools for babelize.co and three MCP prompts.

## Features

- **Local analyze step:** Reports framework, i18n setup, hardcoded strings with file and line, and locale coverage without writing anything.
- **Translate into working tree:** Extracts strings, wires them to next-intl or react-i18next and translates into the locales you name.
- **Locale QA:** Checks for missing keys, lost placeholders, invalid ICU and wrong plural forms.
- **Diff-scoped review:** Limits QA to locale entries changed in the git diff and flags stale translations.
- **Glossary enforcement:** Honors neverTranslate and alwaysTranslateAs terms from project config.
- **Bring your own key:** Works with five LLM providers or a Babelize key.

## Good for

- Make a Next.js app available in German and Japanese
- Preview what localizing an app would take without changing files
- Review a branch's translations against main
- Fix broken placeholders after hand-editing Spanish strings
- Translate Markdown or MDX docs pages

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env BABELIZE_API_KEY='<BABELIZE_API_KEY>' --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env GEMINI_API_KEY='<GEMINI_API_KEY>' --env GROQ_API_KEY='<GROQ_API_KEY>' --env OPENROUTER_API_KEY='<OPENROUTER_API_KEY>' -- npx -y @babelize/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@babelize/mcp"
      ],
      "env": {
        "BABELIZE_API_KEY": "<BABELIZE_API_KEY>",
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "GROQ_API_KEY": "<GROQ_API_KEY>",
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@babelize/mcp"
      ],
      "env": {
        "BABELIZE_API_KEY": "<BABELIZE_API_KEY>",
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "GROQ_API_KEY": "<GROQ_API_KEY>",
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@babelize/mcp"
      ],
      "env": {
        "BABELIZE_API_KEY": "<BABELIZE_API_KEY>",
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "GROQ_API_KEY": "<GROQ_API_KEY>",
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@babelize/mcp"
      ],
      "env": {
        "BABELIZE_API_KEY": "<BABELIZE_API_KEY>",
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "GROQ_API_KEY": "<GROQ_API_KEY>",
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@babelize/mcp"
      ],
      "env": {
        "BABELIZE_API_KEY": "<BABELIZE_API_KEY>",
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "GROQ_API_KEY": "<GROQ_API_KEY>",
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}
```

## Tools

- `babelize_analyze`: Dry-run report on what localizing the app requires.
- `babelize_translate`: Extract, wire and translate strings into the working tree.
- `babelize_check`: QA of locale files.
- `babelize_review`: QA limited to locale entries changed in the git diff.
- `babelize_scan`: List hardcoded strings in a directory.
- `babelize_scan_strings`: Extract translatable strings from a code snippet.
- `babelize_run`: Trigger a translation run on a cloud project.
- `babelize_run_and_wait`: Start a run and wait for it to finish.
- `babelize_status`: Check the status of a translation run.
- `babelize_glossary_get`: List glossary entries for a project.
- `babelize_glossary_set`: Add or update a glossary entry.

## FAQ

### Do I need a Babelize account?

No. Use your own LLM key, or a Babelize API key for hosted translation.

### Why did translate refuse to run?

It requires a clean git tree so its changes form their own diff; commit or stash, or use dryRun or force.

### Does a dry run call the translator?

Yes, dryRun previews on a dirty tree but still calls the translator.

### Which frameworks are supported?

React, Next.js, Django and static HTML; Vue and React Native are in beta.

### Is Babelize free?

Babelize has a free plan, with paid plans for more usage or features.

### How do I add Babelize to Claude Code?

Run this command in your terminal: claude mcp add mcp --env BABELIZE_API_KEY='<BABELIZE_API_KEY>' --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env GEMINI_API_KEY='<GEMINI_API_KEY>' --env GROQ_API_KEY='<GROQ_API_KEY>' --env OPENROUTER_API_KEY='<OPENROUTER_API_KEY>' -- npx -y @babelize/mcp

### What are the best alternatives to Babelize?

The closest alternatives to Babelize are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/babelize
