home / mcp / lokalise mcp server

Lokalise MCP Server

The Lokalise MCP Server brings Lokalise's localization power to Claude and AI assistants—manage projects, keys, and translations by chat.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "abdallahaho-lokalise-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "lokalise-mcp"
      ],
      "env": {
        "DEBUG": "true",
        "LOKALISE_API_KEY": "YOUR_API_KEY_PLACEHOLDER"
      }
    }
  }
}

You want to automate Lokalise localization workflows from your AI assistant. This MCP server connects Lokalise to your AI workflows, enabling multi-tool orchestration for translation management, content updates, and automation templates without manual switchbacks between systems.

How to use

You will run this MCP server alongside your AI client to orchestrate Lokalise actions. Start the server in the background, connect your AI client, and then issue natural-language prompts like “list my projects,” “create translation tasks for EU markets,” or “upload 50 keys from a CSV and generate tasks per language.” The MCP translates your requests into a sequence of Lokalise tools, handles sequencing, and returns structured results you can display in your workflow.

How to install

Prerequisites: Node.js and npm are installed on your machine. You can verify by running node -v and npm -v in your terminal.

Step 1: Install the MCP server globally using npm.

npm install -g lokalise-mcp
lokalise-mcp  # Run the server

Step 2: Get your Lokalise API key and configure the server to use it. You can supply the key via an environment variable or a configuration file.

Step 3: Start the server in HTTP or STDIO mode depending on your client integration. For Claude Desktop-style STDIO integration, use the provided command configuration.

# HTTP mode (development; optional if you prefer a web API endpoint)
npm run mcp:http

# STDIO mode (local integration with Claude Desktop or similar clients)
npm run mcp:stdio

Configuration and security

Environment variables you may use to configure the server include the Lokalise API key and debugging controls.

export LOKALISE_API_KEY="your-api-key-here"

You can also place configuration in a local environment file or a global MCP config, depending on your workflow.

Troubleshooting and notes

If you encounter authentication issues, verify that your Lokalise API key is correct and has the required project access. If you hit rate limits, batch operations when possible and retry after a short pause.

If the server cannot be reached in HTTP mode, ensure the server is running and that your firewall allows traffic on the configured port (default 3000). For STDIO mode, verify the client configuration points to the correct stdio channel.

Getting help and examples

Use practical prompts to exercise multi-tool orchestration. For example, ask the MCP to list projects, upload keys from a CSV, or create translation tasks by language. The server will translate high-level requests into a sequence of Lokalise operations and return actionable results.

Available tools

lokalise_list_projects

List all projects with statistics to understand portfolio scope and health.

lokalise_get_project

Fetch detailed information about a specific Lokalise project.

lokalise_create_project

Create a new Lokalise project with initial settings.

lokalise_update_project

Update settings for an existing project.

lokalise_delete_project

Remove a project from Lokalise.

lokalise_empty_project

Remove all keys from a project without deleting the project itself.

lokalise_list_keys

List keys with optional filename filtering to locate internationalization strings.

lokalise_get_key

Retrieve details for a specific key.

lokalise_create_keys

Create multiple keys at once (up to 1000) with platform tags.

lokalise_update_key

Update a single key's properties.

lokalise_bulk_update_keys

Update multiple keys in bulk, enabling large-scale changes.

lokalise_delete_key

Delete a single key.

lokalise_bulk_delete_keys

Delete multiple keys in a single operation.

lokalise_list_system_languages

List all available languages in the Lokalise system.

lokalise_list_project_languages

List languages configured for a specific project.

lokalise_add_project_languages

Add languages to a project.

lokalise_get_language

Get details about a language configuration.

lokalise_update_language

Update language settings for a project.

lokalise_remove_language

Remove a language from a project.

lokalise_list_usergroups

List all user groups in the workspace.

lokalise_get_usergroup

Get details about a specific user group.

lokalise_create_usergroup

Create a new user group.

lokalise_update_usergroup

Update settings for an existing user group.

lokalise_delete_usergroup

Delete a user group.

lokalise_add_members_to_group

Add members to a user group.

lokalise_remove_members_from_group

Remove members from a user group.

lokalise_add_projects_to_group

Assign projects to a user group.

lokalise_list_translations

List translations with pagination support.

lokalise_get_translation

Get translation details for a key and language.

lokalise_update_translation

Update translations for a key in a specific language.

lokalise_bulk_update_translations

Bulk update multiple translations with a single operation.