Skip to content
Back to search

deepl-mcp-server

A Model Context Protocol (MCP) server that provides translation capabilities using the DeepL API.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/DeepL/deepl-mcp-server with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/DeepL/deepl-mcp-server'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/deepl--deepl-mcp-server/badge.svg)](/listings/deepl--deepl-mcp-server)

HTML

<a href="/listings/deepl--deepl-mcp-server"><img src="/api/listings/deepl--deepl-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 96 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # deepl-mcp-server
  2. [![Version](https://img.shields.io/npm/v/deepl-mcp-server.svg)](https://www.npmjs.org/package/deepl-mcp-server)
  3. [![License: MIT](https://img.shields.io/badge/license-MIT-blueviolet.svg)](https://github.com/DeepL/deepl-mcp-server/blob/main/LICENSE)
  4. > [!NOTE]
  5. > For the best experience and the latest features check out the [DeepL remote MCP server](https://www.deepl.com/en/ai-agents) to use DeepL in your AI agent. No installation required, just add it to Claude, ChatGPT, Microsoft Copilot or any MCP client and sign in with your DeepL account.
  6. >
  7. > Working in a terminal or with a coding agent? [Try the DeepL CLI](https://github.com/DeepL/deepl-cli). It covers translation, documents, glossaries and i18n file sync with your API key.
  8. A Model Context Protocol (MCP) server that exposes DeepL text translation, document translation, rephrasing, and glossary and style rule lookups as MCP tools.
  9. ## Usage
  10. You need Node.js 18 or newer and a DeepL API key. Pick an [API plan](https://www.deepl.com/pro-api?utm_source=github&utm_medium=github-mcp-server-readme) and create a key in your DeepL account.
  11. The server communicates over stdio, so it is normally started by an MCP client rather than by hand. To try it directly:
  12. ```bash
  13. DEEPL_API_KEY=your-api-key npx -y deepl-mcp-server
  14. ```
  15. It exits immediately if `DEEPL_API_KEY` is not set.
  16. To work on the server itself:
  17. ```bash
  18. git clone https://github.com/DeepL/deepl-mcp-server.git
  19. cd deepl-mcp-server
  20. npm install
  21. ```
  22. ## Configuration
  23. Register it as a stdio server with `DEEPL_API_KEY` in the server's environment. In Claude Code:
  24. ```bash
  25. claude mcp add deepl --env DEEPL_API_KEY=your-api-key -- npx -y deepl-mcp-server
  26. ```
  27. For clients configured through a JSON file:
  28. ```json
  29. {
  30. "mcpServers": {
  31. "deepl": {
  32. "command": "npx",
  33. "args": ["-y", "deepl-mcp-server"],
  34. "env": {
  35. "DEEPL_API_KEY": "your-api-key"
  36. }
  37. }
  38. }
  39. }
  40. ```
  41. Where that file lives and how each client expects local stdio servers to be declared:
  42. - [Claude Code](https://code.claude.com/docs/en/mcp)
  43. - [Claude Desktop](https://modelcontextprotocol.io/docs/develop/connect-local-servers)
  44. - [Cursor](https://cursor.com/docs/context/mcp)
  45. - [VS Code](https://code.visualstudio.com/docs/copilot/customization/mcp-servers)
  46. 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.
  47. ## Tools
  48. | Tool | Description | Parameters |
  49. | --------------------------------- | ------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  50. | `translate-text` | Translates text into a target language. | `text`, `targetLangCode`, `sourceLangCode?`, `formality?`, `glossaryId?`, `styleId?`, `context?`, `preserveFormatting?`, `splitSentences?`, `customInstructions?` |
  51. | `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?` |
  52. | `rephrase-text` | Rephrases text, optionally into another language. | `text`, `targetLangCode?`, `style?`, `tone?` |
  53. | `get-source-languages` | Lists the language codes accepted as a translation source. | none |
  54. | `get-target-languages` | Lists the language codes accepted as a translation target. | none |
  55. | `get-writing-styles` | Lists the `style` values `rephrase-text` accepts. | none |
  56. | `get-writing-tones` | Lists the `tone` values `rephrase-text` accepts. | none |
  57. | `list-glossaries` | Lists every glossary in the account with its id, name, dictionaries, and creation time. | none |
  58. | `get-glossary-info` | Returns the same metadata as `list-glossaries` for a single glossary. | `glossaryId` |
  59. | `get-glossary-dictionary-entries` | Returns the term entries of one glossary dictionary, meaning one language pair in one direction. | `glossaryId`, `sourceLangCode`, `targetLangCode` |
  60. | `list-style-rules` | Lists the style rules in the account with their id, name, language, and timestamps. | `page?`, `pageSize?`, `detailed?` |
  61. | `get-style-rule` | Returns one style rule in full, including its configured rules and custom instructions. | `styleId` |
  62. | `get-custom-instruction` | Returns a single custom instruction belonging to a style rule. | `styleId`, `instructionId` |
  63. Notes:
  64. - `text` takes either a single string or an array of strings. Each entry is translated or rephrased independently.
  65. - Language codes are ISO 639-1, optionally with a region (`en-US`). Omitting `sourceLangCode` triggers automatic detection. A target code whose language requires a region gets a default applied: `en` becomes `en-US`, `pt` becomes `pt-BR`, `zh` becomes `zh-Hans`.
  66. - Glossary dictionaries are keyed by non-regional codes, so `get-glossary-dictionary-entries` drops any region you pass.
  67. - Translating with a glossary requires an explicit `sourceLangCode`.
  68. - `formality` accepts `less`, `more`, `default`, `prefer_less`, and `prefer_more`. The `prefer_*` values fall back to the default when the target language has no formality support.
  69. - `translate-document` reads and writes files on the machine running the server. Without `outputFile`, the output path is derived from the input by appending the target language code, for example `report_de.pdf`. With `outputFormat`, the derived path uses that extension instead.
  70. - Style rules and custom instructions are read-only here. Create and edit them in your DeepL account.
  71. ## License
  72. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.