Skip to content
MCP server

Babelize

Localize apps from your coding agent: analyze, translate, check and review i18n locally

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, macOS, Windows
Runs
Locally
Version
1.3.15
Listing updated
2 days ago

About Babelize

Babelize is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "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>"
      }
    }
  }
}

Configuration

  • BABELIZE_API_KEYBabelize API key: Babelize-hosted translation for babelize_translate and the cloud project tools (optional with a BYOK key)
  • BABELIZE_API_URLOverride the Babelize API base URL (optional)
  • ANTHROPIC_API_KEYYour own Anthropic key for babelize_translate (optional)
  • OPENAI_API_KEYYour own OpenAI key for babelize_translate (optional)
  • GEMINI_API_KEYYour own Google Gemini key for babelize_translate (optional)
  • GROQ_API_KEYYour own Groq key for babelize_translate (optional)
  • OPENROUTER_API_KEYYour own OpenRouter key for babelize_translate (optional)
  • BABELIZE_WORKSPACEFolder the local tools may work in (default: client roots, else the working directory)

Tools this server provides (11)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium

Bring your own LLM key, or Babelize-hosted translation with a free tier billed in credits

Prices change. Check docs.babelize.co before you buy.

Babelize 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 to Babelize

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools