@villafinder/tolgee-mcp

MCP server for Tolgee translation management.

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | TOLGEE_TOKEN | Yes | — | API key or Personal Access Token | | PROJECT_ID | Yes | — | Tolgee project ID | | TOLGEE_URL | No | https://app.tolgee.io | Custom/self-hosted Tolgee URL |

Usage

Add to your .mcp.json:

{
  "tolgee": {
    "command": "npx",
    "args": ["-y", "@villafinder/tolgee-mcp"],
    "env": {
      "TOLGEE_URL": "https://your-tolgee-instance.com",
      "TOLGEE_TOKEN": "your-token",
      "PROJECT_ID": "your-project-id"
    }
  }
}

Tools

tolgee_get_keys

Search for existing translation keys.

| Parameter | Required | Description | |-----------|----------|-------------| | filter_keys | Yes | Key names to search for | | namespace | No | Filter by namespace | | languages | No | Language ISO codes to include translations for (e.g. ["en", "fr"]) |

tolgee_create_keys

Create keys with initial translations. Always use tolgee_get_keys first to check for duplicates.

| Parameter | Required | Description | |-----------|----------|-------------| | keys | Yes | List of keys, each with key_name, optional namespace, optional description, and translations (array of {language_iso, translation}) | | tags | No | Tags to apply to all keys |