The SimpleLocalize MCP Server lets you manage translations, translation keys, languages, tags, and hosting environments in your SimpleLocalize project directly through AI tools.
Translation Keys
Create, update, retrieve, and delete keys in bulk (up to 100 per operation)
Metadata support: namespaces, descriptions, tags, character limits, lock/deprecation status
Bulk failures return a list instead of throwing errors, allowing partial success
Translations
Update up to 100 translations simultaneously, including language, text, review status, and customer-specific overrides
Retrieve and filter translations by key, namespace, language, text content (min 3 chars), review status, and customer ID, with pagination and sorting
Tags
List all tags and create new ones with a custom name and hex color
Languages
List all configured languages and add new ones by key (e.g.
en,pl_PL) with an optional display name
Hosting Environments
List all environments (including built-in
_latestand_production)Get details/status for a specific environment
Publish translations to a specified environment with optional labels
Compatible with MCP clients like Claude Desktop, Cursor, and VS Code — requires only an API key for setup.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SimpleLocalize MCP Serverlist all translation keys in my project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Server for SimpleLocalize
SimpleLocalize is the developer-first translation management system.
This is a Model Context Protocol (MCP) server that provides tools for interacting with the SimpleLocalize API.
Features (Tools)
Create translation key (bulk)
Update translations (bulk)
Get all translation keys
Get translation key details
Update translation key
Delete translation keys (bulk)
Get tags
Create tag
Get languages
Create languages
Get translations
Get hosting environments
Get hosting environment details
Publish translations to hosting
Feel free to add more tools by making a pull request or creating a feature request.
Installation
To use the MCP server, you'll need an API key. You can create and manage API keys in SimpleLocalize > Settings > Credentials -> Project API Key:
To run the server in a client like Claude Desktop, Cursor or Windsurf, add the following to your MCP config:
{
"servers": {
"simplelocalize": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@simplelocalize/simplelocalize-mcp", "--api-key=SIMPLELOCALIZE_API_KEY"]
}
}
}Replace SIMPLELOCALIZE_API_KEY with your API key
For detailed setup guides, see:
Development
Install dependencies:
pnpm installBuild the server:
pnpm buildUpdate client to use the local build:
{ "servers": { "simplelocalize": { "command": "node", "args": ["path/to/simplelocalize-mcp-server/build/index.js"], "env": { "SIMPLELOCALIZE_API_KEY": "your_api_key" } } } }
Debugging
To debug the MCP server, you can use the MCP Inspector tool:
Run the server with the inspector:
pnpm inspectorOpen the provided URL in your browser to view and debug the MCP requests and responses.
Include the
--api-keyargument.
Learn more
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.