deepl-mcp-server

What is deepl-mcp-server?

A Model Context Protocol (MCP) server that provides translation capabilities using the DeepL API. It enables AI assistants to translate text and documents, rephrase text, and leverage DeepL glossaries for consistent terminology. Designed for developers integrating DeepL translation into AI workflows.

How to use deepl-mcp-server?

Run with npx deepl-mcp-server (no installation required). A DeepL API key is mandatory, set via the DEEPL_API_KEY environment variable. Integrate with Claude Desktop by editing claude_desktop_config.json or use claude mcp add with Claude Code.

Key features of deepl-mcp-server

• Translate text between numerous supported languages
• Translate documents (PDF, DOCX, PPTX, HTML, TXT, etc.)
• Rephrase text with configurable style and tone
• Automatic source language detection
• Formality control for supported languages
• Glossary support for consistent terminology translation
• List available source and target languages

Use cases of deepl-mcp-server

• Translate user text inline during AI conversations (e.g., in Claude Desktop)
• Automatically translate uploaded documents via an AI agent with filesystem access
• Rephrase existing content to match business, academic, or casual styles
• Enforce consistent terminology by applying custom DeepL glossaries to translations

FAQ from deepl-mcp-server

What API key do I need and is there a free tier?

You need a DeepL API key from deepl.com/pro-api. A free account lets you translate up to 500,000 characters per month.

What tools does the server provide?

It provides translate-text, translate-document, rephrase-text, get-source-languages, get-target-languages, list-glossaries, get-glossary-info, get-glossary-dictionary-entries, get-writing-styles, and get-writing-tones.

How do I configure it with Claude Desktop?

Create or edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %AppData%\Claude\, Linux: ~/.config/Claude/). Add an entry with command: "npx", args: ["deepl-mcp-server"], and env: { "DEEPL_API_KEY": "your-key" }.

What document formats are supported for translation?

PDF, DOCX, PPTX, XLSX, HTML, TXT, and more.

How does glossary support work?

You can list all glossaries (list-glossaries), get metadata for a specific glossary (get-glossary-info), and retrieve actual term entries (get-glossary-dictionary-entries). Use the glossaryId parameter in translate-text or translate-document to apply a glossary for consistent terminology.