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.
Configure your mcp.json file and add 'simplelocalize':
{
"mcpServers": {
"simplelocalize": {
"command": "npx",
"args": [
"-y",
"@simplelocalize/simplelocalize-mcp",
"--api-key=PROJECT_API_KEY"
]
}
}
}
Translation keys
- Get translation keys
- Create translation key
- Update translation key
- Delete translation key
- Upload translation key screenshot (base64 or file)
Translations
- Get translations
- Update translation (single and bulk)
Auto-translation
- Auto-translate text
- Create auto-translation jobs
- Get auto-translation jobs
Tags, languages & customers
- Get/create/update/delete tags
- Get/create/update/delete languages
- Get/create/update/delete customers
Hosting & publishing
- Get/create hosting environments
- Get hosting environment details
- Publish translations to hosting
Import, export & activity
- Import translations from a local file
- Export translations to downloadable file(s)
- Get supported file formats
- Get project activity
Glossary
- Get glossary entries
- Create glossary entry
- Delete glossary entry
Project
- Get project details
Feel free to add more tools by making a pull request or creating a feature request.
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:
-
Install dependencies:
pnpm install
-
Build the server:
pnpm build
-
Update 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" } } } }
To debug the MCP server, you can use the MCP Inspector tool:
-
Run the server with the inspector:
pnpm inspector
-
Open the provided URL in your browser to view and debug the MCP requests and responses.
-
Include the
--api-keyargument.