Tolgee MCP Server: Setup for Claude, Cursor and Other Apps

• Finds translation keys by name or text

  Searches a project for keys whose name or translation text matches, up to 50 per page. Filtering by namespace or tag is not supported yet, so filter the results yourself.

  Try: “Find keys that contain "welcome" in any translation.”

  Network · search_keys

• Lists the translation keys in a project

  Returns the keys of a project, up to 100 per page.

  Try: “List the keys in my Tolgee project.”

  Network · list_keys

• Shows one key and its details

  Returns the name, namespace and description of a key. Use the translations tool to see its texts.

  Try: “Show me the details of the key homepage.title.”

  Network · get_key

• Shows a key's translations

  Returns the translations of one key in every project language, or only the languages you name.

  Try: “What is homepage.title in German and French?”

  Network · get_translations

• Writes or changes a translation

  Sets the text of an existing key in one or more languages. The key has to exist first.

  Try: “Set the German text of homepage.title to "Willkommen".”

  Write · set_translation

• Adds new translation keys

  Creates keys with optional translations and tags. A key that already exists is skipped and left unchanged.

  Try: “Add keys for the new checkout page with English texts.”

  Write · create_keys

• Renames a key or edits its details

  Changes a key's name, namespace or description.

  Try: “Move the key cta.signup into the "homepage" namespace.”

  Write · update_key

• Deletes translation keys

  Removes keys from a project. This cannot be undone, and the assistant is told to ask you first.

  Try: “Delete the unused keys that start with legacy_.”

  Delete · delete_keys

• Translates keys automatically

  Starts a machine translation job for the keys and languages you choose, and returns a job ID.

  Try: “Machine translate these keys into German and French.”

  Write · machine_translate

• Checks on a translation job

  Reports how far a batch job, such as machine translation, has got, so the assistant can wait for it to finish.

  Try: “Is the translation job finished?”

  Network · get_batch_job_status

• Shows translation progress per language

  Returns the share of translated, reviewed and untranslated texts for each language of a project.

  Try: “How complete is each language in my project?”

  Network · get_project_language_statistics

• Lists the project's languages

  Returns the languages set up in a project, up to 1000 per page.

  Try: “Which languages does this project have?”

  Network · list_languages

• Adds a language to a project

  Adds a new language to a project.

  Try: “Add Japanese to this project.”

  Write · create_language

• Lists the tags in a project

  Returns every tag used in a project, up to 1000 per page.

  Try: “What tags do we use?”

  Network · list_tags

• Adds tags to keys

  Puts tags on translation keys and creates the tags if they do not exist.

  Try: “Tag all checkout keys with "needs-review".”

  Write · tag_keys

• Lists the project's namespaces

  Returns the namespaces that group keys by feature, page or module.

  Try: “List the namespaces in this project.”

  Network · list_namespaces

• Tells Tolgee which keys belong together

  Saves which keys appear near each other in your code, so machine translation can use the translations of related keys as context.

  Try: “Mark the keys on the pricing page as related.”

  Write · store_big_meta

• Lists your Tolgee projects

  Returns the projects you can reach, with an optional name search. It needs a Personal Access Token and is refused for a signed-in session.

  Try: “Which Tolgee projects do I have?”

  Network · list_projects

• Creates a new project

  Creates a project with its first languages. It needs a Personal Access Token and is refused for a signed-in session.

  Try: “Create a project called Mobile App with English and Spanish.”

  Write · create_project

• Lists a project's branches

  Returns up to 100 branches. Only works for projects with branching turned on, which is an enterprise feature.

  Try: “What branches does this project have?”

  Network · list_branches

• Creates a branch

  Forks a new branch from an existing one. Branching is an enterprise feature.

  Try: “Create a branch called feature-x from main.”

  Write · create_branch

• Deletes a branch

  Removes a branch from the project. This cannot be undone, and the assistant is told to ask you first.

  Try: “Delete the branch feature-x.”

  Delete · delete_branch

Watch out for

• It can delete keys and branches for good

  Two tools remove keys and branches, and Tolgee says this cannot be undone. The assistant is told to confirm first, so read the request before you approve it. docs.tolgee.io

• A Personal Access Token reaches every project

  A Project API Key covers one project, but a Personal Access Token carries all your permissions. Prefer sign-in for a single project, or a Project API Key. docs.tolgee.io

• No read-only switch

  The docs describe no read-only setting. Start with read requests and keep the connection tied to one project. docs.tolgee.io

Security advisories