I18next MCP Server
Manage translation files and sync i18next keys directly from your AI assistant.
Data last scanned today · Reviewed today
Overview
I18next MCP Server provides a specialized interface for handling internationalization workflows within i18next projects. By integrating with an AI client, it enables developers to automate the lifecycle of translation files, ensuring consistency and completeness across multiple languages. It supports directory-based translation management, typically pointing to local structures like public/locales. The server includes a suite of tools for auditing, syncing, and modifying keys. You can scan codebases for missing references, perform health checks on translation files, and export data in various formats. Setup is handled via environment variables that define your project root and supported language sets, allowing for straightforward integration into local environments.
Our verdict
This server receives a high-risk score of 18/100 due to its community-maintained nature, single-contributor bus factor, and lack of recent updates (last commit over 400 days ago). Because it does not offer a read-only mode, any installation grants full write access to your filesystem, which requires cautious configuration. We recommend this tool only for non-production environments or developers who have manually audited the code for write-access safety.
- Small dependency footprint with only seven direct packages
- Comprehensive toolset for scanning and syncing translation keys
- Clear documentation provided in the repository README
- High security risk due to lack of a read-only mode
- Maintenance concern with no commits in over 400 days
- Single-contributor project with limited community oversight
Setup
{
"mcpServers": {
"i18next-mcp-server": {
"args": [
"-y",
"i18next-mcp-server"
],
"command": "npx"
}
}
}Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.
- No read-only mode — running this grants full read/write access.
- No built-in authentication — anyone with access to this config can invoke every tool it exposes.
Tools
| Tool | Description | Risk |
|---|---|---|
| get_project_info | Get project configuration and statistics | low |
| health_check | Analyze translation file health and completeness | low |
| scan_code_for_missing_keys | Find missing translation keys in your code | low |
| add_translation_key | Add new translation keys | medium |
| sync_missing_keys | Sync missing keys between languages | medium |
| get_missing_keys | List missing keys by language | low |
| list_files | List all translation files | low |
| validate_files | Validate JSON syntax | low |
| export_data | Export translations to various formats | low |
| coverage_report | Translation coverage statistics | low |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf | ||||
| ChatGPT |
Frequently asked questions
›What are the required environment variables for configuration?
The server requires I18N_PROJECT_ROOT for the project directory, I18N_LOCALES_PATH for the translation files location, I18N_DEFAULT_LANGUAGE for the source language, and I18N_SUPPORTED_LANGUAGES for the list of supported language codes.
›Can I run this server without a local installation?
Yes, you can run the server directly using npx i18next-mcp-server@latest without needing a manual installation.
›What is the expected directory structure for translation files?
The server expects translation files to be organized under a locales directory, typically structured as your-project/public/locales/[language-code]/[file-name].json.
›What types of analysis can the server perform on my translation files?
The server provides tools for checking file health, reporting translation coverage, identifying unused translation keys, and analyzing translation quality.
Badge
Maintain this server? Add the live badge to your README.