Summary
Connects Claude to DeepL's translation API with support for text, document, and rephrasing operations. You get access to all DeepL language pairs with automatic detection, formality controls for formal/informal register, and glossary support for consistent terminology. The translate-document tool handles PDFs, DOCX, PPTX, and other formats directly, while the glossary tools let you list, inspect, and retrieve term entries from your DeepL glossaries. Requires a DeepL API key, which includes 500,000 free characters monthly on their free tier. Reach for this when you need production-grade translation integrated into Claude workflows, especially if you're already using DeepL glossaries or need document translation beyond plain text.
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →deepl-mcp-server
A Model Context Protocol (MCP) server that exposes DeepL text translation, document translation, rephrasing, and glossary and style rule lookups as MCP tools.
Usage
You need Node.js 18 or newer and a DeepL API key. Pick an API plan and create a key in your DeepL account.
The server communicates over stdio, so it is normally started by an MCP client rather than by hand. To try it directly:
DEEPL_API_KEY=your-api-key npx -y deepl-mcp-server
It exits immediately if DEEPL_API_KEY is not set.
To work on the server itself:
git clone https://github.com/DeepL/deepl-mcp-server.git
cd deepl-mcp-server
npm install
Configuration
Register it as a stdio server with DEEPL_API_KEY in the server's environment. In Claude Code:
claude mcp add deepl --env DEEPL_API_KEY=your-api-key -- npx -y deepl-mcp-server
For clients configured through a JSON file:
{
"mcpServers": {
"deepl": {
"command": "npx",
"args": ["-y", "deepl-mcp-server"],
"env": {
"DEEPL_API_KEY": "your-api-key"
}
}
}
}
Where that file lives and how each client expects local stdio servers to be declared:
To run a local checkout instead of the published package, use node as the command and the absolute path to src/index.mjs as the argument.
Tools
| Tool | Description | Parameters |
|---|---|---|
translate-text | Translates text into a target language. | text, targetLangCode, sourceLangCode?, formality?, glossaryId?, styleId?, context?, preserveFormatting?, splitSentences?, customInstructions? |
translate-document | Translates a document file (PDF, DOCX, PPTX, XLSX, HTML, TXT, and more) and writes the result to disk. | inputFile, targetLangCode, outputFile?, sourceLangCode?, formality?, glossaryId?, styleId?, outputFormat? |
rephrase-text | Rephrases text, optionally into another language. | text, targetLangCode?, style?, tone? |
get-source-languages | Lists the language codes accepted as a translation source. | none |
get-target-languages | Lists the language codes accepted as a translation target. | none |
get-writing-styles | Lists the style values rephrase-text accepts. | none |
get-writing-tones | Lists the tone values rephrase-text accepts. | none |
list-glossaries | Lists every glossary in the account with its id, name, dictionaries, and creation time. | none |
get-glossary-info | Returns the same metadata as list-glossaries for a single glossary. | glossaryId |
get-glossary-dictionary-entries | Returns the term entries of one glossary dictionary, meaning one language pair in one direction. | glossaryId, sourceLangCode, targetLangCode |
list-style-rules | Lists the style rules in the account with their id, name, language, and timestamps. | page?, pageSize?, detailed? |
get-style-rule | Returns one style rule in full, including its configured rules and custom instructions. | styleId |
get-custom-instruction | Returns a single custom instruction belonging to a style rule. | styleId, instructionId |
Notes:
texttakes either a single string or an array of strings. Each entry is translated or rephrased independently.- Language codes are ISO 639-1, optionally with a region (
en-US). OmittingsourceLangCodetriggers automatic detection. A target code whose language requires a region gets a default applied:enbecomesen-US,ptbecomespt-BR,zhbecomeszh-Hans. - Glossary dictionaries are keyed by non-regional codes, so
get-glossary-dictionary-entriesdrops any region you pass. - Translating with a glossary requires an explicit
sourceLangCode. formalityacceptsless,more,default,prefer_less, andprefer_more. Theprefer_*values fall back to the default when the target language has no formality support.translate-documentreads and writes files on the machine running the server. WithoutoutputFile, the output path is derived from the input by appending the target language code, for examplereport_de.pdf. WithoutputFormat, the derived path uses that extension instead.- Style rules and custom instructions are read-only here. Create and edit them in your DeepL account.
License
MIT
Featured
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
