MCP Server for DeepL Translation API
Configuration
View docs{
"mcpServers": {
"watchdealer-pavel-deepl-mcp-server": {
"command": "node",
"args": [
"/path/to/deepl-mcp-server/build/index.js"
],
"env": {
"DEEPL_API_KEY": "your-api-key-here"
}
}
}
}You can run a dedicated MCP Server that accesses DeepL translation capabilities, making it easy to translate text, adjust formality, and query language options from your existing MCP client setup. This server bridges your client with the DeepL API and manages translation tasks efficiently within your workflow.
You use the DeepL MCP Server by running the local server process and pointing your MCP client to it. The server exposes five tools for translation tasks: translate_text, rephrase_text, get_source_languages, get_target_languages, and get_usage. You can translate single texts or batches, control formality for specific languages, provide context to improve accuracy, and leverage glossary support when you need consistent terminology. Your MCP client can request the available source and target languages and monitor usage to stay within your plan limits.
Prerequisites you need before starting are Node.js 18 or newer (including Node.js 25) and a DeepL API key. Install and run steps are shown in practical sequence.
Use the following sample configurations to connect your MCP client to the local server. This demonstrates how to run the server locally and pass your API key via environment variables.
{
"mcpServers": {
"deepl": {
"command": "node",
"args": ["/path/to/deepl-mcp-server/build/index.js"],
"env": {
"DEEPL_API_KEY": "your-api-key-here"
}
}
}
}The following configuration illustrates how to load the local DeepL MCP Server into Claude Desktop. Adjust the path to point at where you build the server.
{
"mcpServers": {
"deepl": {
"command": "node",
"args": ["/path/to/deepl-mcp-server/build/index.js"],
"env": {
"DEEPL_API_KEY": "your-api-key-here"
}
}
}
}The following example shows how to configure Claude Code to load the local DeepL MCP Server from your project.
{
"mcpServers": {
"deepl": {
"command": "node",
"args": ["/path/to/deepl-mcp-server/build/index.js"],
"env": {
"DEEPL_API_KEY": "your-api-key-here"
}
}
}
}When you start the local server, you can call the five available tools through your MCP client. Translate text with target language and optional formality, request rephrasing (with Pro access where available), list source and target languages, and check the current API usage.
The server is designed to auto-detect the API type based on your key format. Keys ending with ":fx" use the Free API endpoint, while other keys use the Pro API endpoint. Ensure your API key is kept secure and not exposed in client-side code.
If translations fail, verify that your DEEPL_API_KEY is correctly set in the environment, confirm network access to the DeepL API, and check that you started the server with the correct path to the built index. Review usage statistics to ensure you have remaining quota.
The server supports batch translation, preserves formatting, and allows you to control sentence splitting. You can also supply context for improved accuracy and use glossary IDs for consistent terminology.
Translate text with formality control, context, and glossary support
Improve text clarity and style using DeepL Write (Pro only)
List all available source languages
List all target languages with formality support info
Get API usage statistics (character count and limits)