Tolgee

io.github.tolgeePublished by GitHub account tolgeev1.0.0Updated Oct 24, 2026

Your app's translations in Tolgee: search keys, create translations, trigger machine translation

VerifiedStreamable HTTPWeb executableProductivity & WorkflowDeveloper Tools

Overview

AI-generated overview

Tolgee's hosted MCP server lets an AI assistant manage localization projects: search and create translation keys, set translations, and trigger machine…

What you can do
  • List and create projects, and view per-language translation statistics
  • List, search, create, update and delete translation keys, and read their metadata
  • Get and set translations for keys across project languages
  • List and add languages, list namespaces, list and add tags to keys
  • Start machine translation for keys and poll batch job status
  • List, create and delete project branches (enterprise branching projects)
When to use it
Useful when you work on a Tolgee-localized app and want an assistant to find keys, fill in or adjust translations, add languages or tags, or kick off machine translation without leaving the editor.
Requirements
A remote MCP endpoint at app.tolgee.io (or a self-hosted instance), a Tolgee account with access to the target projects, and an API key sent in the X-API-Key header — either a personal access token or a project API key.
Before you install
The API key grants access to your Tolgee projects; keep it scoped and private. Deleting keys and branches is destructive and the server asks the assistant to confirm with you first. Creating keys, setting translations, tagging and machine translation all change project data, and machine translation may consume paid translation service quotas configured in Tolgee.

Installation

In SourceWeft

  1. Open Tolgee in the dashboard and add it to a workspace.
  2. Connect X-API-Key credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.tolgee%2Ftolgee/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "tolgee": {
      "type": "http",
      "url": "https://app.tolgee.io/mcp/developer",
      "headers": {
        "X-API-Key": "<YOUR_API_KEY>"
      }
    }
  }
}

README

Tolgee
 An open-source localization platform
developers enjoy working with

[Tolgee]

Why use Tolgee?

It saves you valuable time that would otherwise be spent on localization tasks while ensuring your software is flawlessly translated.

[Frame 47]

In context translating & One click screenshots

Easily add translations to your code and edit them directly within your app using the Tolgee i18n tool. Simply hold the ALT/Option key and click on an element to open a dialog where you can modify your strings effortlessly—no need to navigate through bulky .json/.po/.whatever files. Plus, in-context translation works seamlessly even in the production environment.

Just one click—that’s all it takes to capture a screenshot of your application with highlighted phrases for translation. Simply hold ALT + click on a string, then hit the camera button. Boom! Your screenshot is instantly generated.

[Tolgee in-context editing]

Translating on production

In-context translation works seamlessly even in the production environment of your deployed app. With the Tolgee Tools Chrome plugin, simply enter your API key and start translating—no coding skills required. This makes it easy for anyone to contribute to your app’s translations effortlessly.

True integrations

Tolgee isn't just another localization platform that simply syncs your local data with a backend. Instead, it seamlessly integrates into your app through powerful SDKs, providing a truly embedded translation experience.

Machine translation

We support DeepL, Google Translate, AWS Translate, and Azure Translator—simply choose your preferred services in the settings. With machine translation, the localization process becomes significantly faster, allowing translators to leverage AI-powered suggestions for more efficient and accurate translations.

AI translator

Conventional machine translation sees one string at a time. The AI translator sees the situation around it: screenshots of the phrase in your app, the key and project descriptions, your language notes, matches from the translation memory, and Tolgee Context, which the SDK gathers from how keys are actually laid out in your application.

The result is that ambiguous strings stop being a coin flip. A bare "Open" can be a button, a status or a menu item, and the AI translator picks based on where it appears—then tells you which reading it went with, so a reviewer can disagree at a glance.

You can shape it further by describing your project and languages, or by editing the translation prompt directly. Read more.

Translation memory

Tolgee automatically suggests translations based on those you've previously used in the project, ensuring consistency across similar phrases.

Translation memory suggestions include the similarity percentage, the key, and the original text of the translated string, making it easy to maintain accuracy and coherence.

Auto translation

When enabled, Tolgee instantly translates new keys using translation memory or machine translation services, ensuring your strings are translated immediately upon creation. Simply choose whether to use translation memory and select your preferred machine translation service for seamless automation.

Activity log

Easily track who modified, reviewed, or commented on phrases in your project—all with complete clarity.

Comment on translations

If something seems off, let others know what you'd change. You can leave comments on any translation directly within the Tolgee platform.

Translation history

Easily track changes to specific translations of a particular key in a specific language. If something's amiss, you'll know exactly where to point the finger!

MCP Server

Tolgee exposes an MCP (Model Context Protocol) server that lets AI coding assistants manage translations directly — search keys, create and update translations, manage languages, trigger machine translation, and more — all without leaving your editor. See DEVELOPMENT.md for setup instructions.

Documentation

The docs cover all aspects of using Tolgee. Some highlights include:

Getting Started 🚀

  1. Sign up at app.tolgee.io or access your self-hosted instance
  2. Create a project
  3. Follow a guide in the integration section of your project
  4. Have fun!

[Integration guides]

Report a Bug

For filing bugs, suggesting improvements, or requesting new features, please open an issue.

How to contribute

You wanna contribute? Great to hear that! You can start right away!

Contributors

[contributors]

Let us know what you think! #FeedbackWanted ❤️

Source: README.md at commit 1c6139c

Tools

22

get_batch_job_status

Get the status of a batch job (e.g. machine translation) by its ID. Use to poll for completion.

ParametersjobIdrequiredprojectId

machine_translate

Start machine translation for specified keys into target languages. Returns a batch job ID — use get_batch_job_status to poll for completion.

ParametersbranchkeyNamesrequirednamespaceprojectIdtargetLanguageTagsrequired

store_big_meta

Store key relationships so Tolgee can use translations of related keys as context during machine translation, producing more consistent results. Keys that appear near each other in source code (e.g. on the same page or component) should be stored as related.

ParametersbranchprojectIdrelatedKeysInOrderrequired

list_branches

List branches in a Tolgee project. Returns up to 100 results per page. Only available for projects with branching enabled (enterprise feature).

ParameterspagesearchprojectId

create_branch

Create a new branch in a Tolgee project by forking from an existing branch. Only available for projects with branching enabled (enterprise feature).

ParametersnamerequiredprojectIdoriginBranchIdrequired

delete_branch

Delete a branch from a Tolgee project. IMPORTANT: This is a destructive operation. The AI assistant should always confirm with the user before calling this tool.

ParametersprojectIdbranchNamerequired

list_keys

List translation keys in a Tolgee project. Returns up to 100 keys per page. Use search_keys to find specific keys by name or translation text.

ParameterspagebranchprojectId

search_keys

Search for translation keys in a Tolgee project by name or translation text. Returns up to 50 matching keys per page. Note: namespace and tags filtering is not yet supported — filter results client-side if needed.

ParameterspagequeryrequiredbranchprojectIdlanguageTag

create_keys

Create translation keys in a Tolgee project with optional translations and tags. Keys that already exist are silently skipped — their translations and tags are not updated. Use update_key and set_translation to modify existing keys.

ParameterskeysrequiredbranchnamespaceprojectId

get_key

Get a translation key's metadata (name, namespace, description) by its name. To get the key's translations, use get_translations.

ParametersbranchkeyNamerequirednamespaceprojectId

update_key

Update an existing translation key's name, namespace, or description

ParameterskeyNamerequirednewNamerequiredkeyBranchprojectIdkeyNamespacenewNamespacenewDescription

delete_keys

Delete translation keys from a Tolgee project. IMPORTANT: This is a destructive operation. The AI assistant should always confirm with the user before calling this tool.

ParametersbranchkeyNamesrequirednamespaceprojectId

list_languages

List all languages configured for a Tolgee project. Returns up to 1000 results per page.

ParameterspageprojectId

create_language

Add a new language to a Tolgee project

ParameterstagrequirednamerequiredflagEmojiprojectIdoriginalName

list_namespaces

List all namespaces in a Tolgee project. Namespaces organize translation keys into logical groups (e.g. by feature, page, or module).

ParametersprojectId

list_projects

List Tolgee projects accessible to the current user. Returns up to 100 results per page.

Parameterspagesearch

create_project

Create a new Tolgee project with initial languages

ParametersnamerequiredlanguagesrequiredorganizationIdrequiredbaseLanguageTag

get_project_language_statistics

Get translation status and progress for each language in a project. Returns per-language statistics including translated, reviewed, and untranslated percentages.

ParametersprojectId

list_tags

List all tags used in a Tolgee project. Returns up to 1000 results per page.

ParameterspagesearchprojectId

tag_keys

Add tags to translation keys. Creates tags if they don't exist.

ParameterstagsrequiredbranchkeyNamesrequirednamespaceprojectId

get_translations

Get translations for a specific key in a Tolgee project. Returns translations in all project languages, or only the specified languages if provided.

ParametersbranchkeyNamerequiredlanguagesnamespaceprojectId

set_translation

Set or update translations for a key in one or more languages. The key must already exist — use create_keys to create it first.

ParametersbranchkeyNamerequirednamespaceprojectIdtranslationsrequired

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.