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.

How to setup

Configure your mcp.json file and add 'simplelocalize':

{
  "mcpServers": {
    "simplelocalize": {
      "command": "npx",
      "args": [
        "-y",
        "@simplelocalize/simplelocalize-mcp",
        "--api-key=PROJECT_API_KEY"
      ]
    }
  }
}

Related MCP server: texterify-mcp

Features (Tools)

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.

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