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)

This server covers the full SimpleLocalize API.

Translation keys

• Get translation keys (with metadata, paginated) / get all translation keys (lightweight, v1 and v2)
• Get translation key details
• Create translation key (single and bulk)
• Update translation key (by key/namespace, or by ID)
• Delete translation key (single and bulk)
• Upload translation key screenshot (base64, local file, or bulk)

Translations

• Get translations
• Update translation (single and bulk)

Auto-translation

• Auto-translate text (single, synchronous, not saved to the project)
• Create auto-translation jobs (async, saved to the project)
• Get auto-translation jobs / get auto-translation job

Tags, languages & customers

• Get/create/update/delete tags
• Get/create/update/delete languages
• Get/create/update/delete customers (for customer-specific translations)

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 / get activity changes

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.

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:

• Cursor AI
• Visual Studio Code
• GitHub Copilot
• Claude Desktop
• Windsurf

Development

1. Install dependencies:

   pnpm install

2. Build the server:

   pnpm build

3. 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"
         }
       }
     }
   }

Debugging

To debug the MCP server, you can use the MCP Inspector tool:

1. Run the server with the inspector:

   pnpm inspector

2. Open the provided URL in your browser to view and debug the MCP requests and responses.

3. Include the --api-key argument.

Learn more

• SimpleLocalize developer docs
• SimpleLocalize API reference
• Sign up for SimpleLocalize