locaflow-mcp-server

Translate iOS, Android & web localization files directly from Claude Code. Powered by LocaFlow.

Quick setup (2 minutes)

Step 1: Install

npm i -g locaflow-mcp-server

Step 2: Add to Claude Code

Open your Claude Code settings and add the MCP server:

claude mcp add locaflow -- locaflow-mcp

Or manually add to ~/.claude/settings.json:

{
  "mcpServers": {
    "locaflow": {
      "command": "locaflow-mcp"
    }
  }
}

Step 3: Use it

Open Claude Code in any project and say:

"Scan this project for localization files"
"Translate my Localizable.strings to Spanish and Japanese"
"Translate my App Store description to French, German, and Korean"

That's it. No API key needed — works in free demo mode (50 strings/day). For unlimited translations, set LOCAFLOW_TOKEN in the env config.

Tools

scan_project

Find all localization files in a project directory. Reports file paths, formats, and string counts.

"What localization files does this project have?"
"Scan my project for iOS localization files"

translate_file

Translate a .strings, strings.xml, or .json file. Writes output in the correct platform convention:

• iOS: es.lproj/Localizable.strings
• Android: values-es/strings.xml
• Web: es.json

"Translate my Localizable.strings to Spanish and Japanese"
"Translate strings.xml to French, German, and Korean"

translate_text

Translate any text. Good for release notes, UI copy, quick checks.

"Translate 'Welcome back!' to Korean"

translate_appstore_metadata

Translate App Store metadata (name, subtitle, description, keywords, what's new).

"Translate my app description and keywords to Spanish and Japanese"

appstore_fetch_metadata

Pull current metadata from App Store Connect. Returns version ID needed for pushing.

appstore_push_metadata

Push translated metadata to App Store Connect.

"Fetch my App Store metadata, translate it to 5 languages, and push it back"

Supported formats

| Platform | Translatable files | Output convention | |----------|-------------------|-------------------| | iOS | .strings | {lang}.lproj/ | | Android | strings.xml | values-{lang}/ | | Web | .json | {lang}.json |

Supported languages

30+ languages including: es, fr, de, ja, ko, zh-Hans, zh-Hant, pt-BR, ar, hi, ru, tr, nl, sv, da, fi, nb, pl, cs, el, he, th, vi, id, ms, uk, ro, hu, and more.

Configuration

| Environment variable | Description | |---------------------|-------------| | LOCAFLOW_TOKEN | Optional. Your LocaFlow auth token for unlimited translations. Without it, demo mode (50 strings/day). |

To set the token:

{
  "mcpServers": {
    "locaflow": {
      "command": "locaflow-mcp",
      "env": {
        "LOCAFLOW_TOKEN": "your-token-here"
      }
    }
  }
}

License

MIT