I18next MCP Server

A comprehensive Model Context Protocol (MCP) server for i18next translation management, health checking, and automated translation workflows

Local serverstdio

What is the I18next MCP server?

I18next MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. A comprehensive Model Context Protocol (MCP) server for i18next translation management, health checking, and automated translation workflows.

What you get

A Model Context Protocol (MCP) server that provides translation management capabilities for i18next projects, enabling AI assistants like Cursor to directly interact with translation files.

Setting it up

Installation goes through your MCP client rather than a global install: point it at i18next-mcp-server on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

What the assistant can call

Once I18next is connected, these are the calls the assistant has available:

  • Analysis — The Analysis tool exposed by this server

Configuration and credentials

You will need 4 environment variables: I18N_PROJECT_ROOT, I18N_LOCALES_PATH, I18N_DEFAULT_LANGUAGE, I18N_SUPPORTED_LANGUAGES. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the i18next mcp server does with a few real requests.

Choosing this one

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. I18next's toolset — Analysis — is a fair guide to whether it matches your workflow. It is maintained by gtrias; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against I18next's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Available tools

ToolWhat it does
AnalysisThe Analysis tool exposed by this server.

How to install the I18next MCP server

{
  "mcpServers": {
    "i18next": {
      "command": "npx",
      "args": ["-y", "i18next-mcp-server"],
      "env": {
        "I18N_PROJECT_ROOT": "your-value",
        "I18N_LOCALES_PATH": "your-value",
        "I18N_DEFAULT_LANGUAGE": "your-value",
        "I18N_SUPPORTED_LANGUAGES": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
I18N_PROJECT_ROOTConfiguration value read at startup.Optional
I18N_LOCALES_PATHFilesystem location the server is allowed to use.Optional
I18N_DEFAULT_LANGUAGEConfiguration value read at startup.Optional
I18N_SUPPORTED_LANGUAGESConfiguration value read at startup.Optional

Example prompts to try

  • Use I18next to Analysis.

Frequently asked questions

It connects I18next to MCP-compatible AI assistants such as Claude and Cursor, exposing 1 tool (Analysis) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with I18next directly.