Poeditor MCP

🚀 POEditor MCP Server

A Model Context Protocol (MCP) server for interacting with POEditor's translation management API.

🚀 Quick Start

This is a Model Context Protocol (MCP) server designed for interacting with POEditor's translation management API. It allows you to perform various operations related to translation management efficiently.

📦 Installation

To install the POEditor MCP Server, run the following commands:

npm install
npm run build

📚 Documentation

Configuration

Configure the MCP server in your client (e.g., Claude Desktop) by adding it to your MCP settings:

{
  "mcpServers": {
    "poeditor": {
      "command": "npx",
      "args": ["tsx", "/path/to/poeditor-mcp/src/server.js"],
      "env": {
        "POEDITOR_API_TOKEN": "your_api_token_here",
        "POEDITOR_PROJECT_ID": "your_project_id"
      }
    }
  }
}

⚠️ Important Note

• POEDITOR_API_TOKEN is required. You can get it from POEditor API Access.
• POEDITOR_PROJECT_ID is optional. It's the default project ID and can be overridden per tool call.

Available Tools

• add_terms_with_translations ⭐ PREFERRED - Create multiple new terms and add their translations in one operation.
• add_translations - Add translations for existing terms (does not overwrite).
• update_translations - Update/overwrite existing translations.
• list_terms - List all terms (with optional translations).
• list_languages - List languages currently enabled in a project.
• list_available_languages - List all languages that POEditor supports (for reference when adding languages).
• add_language - Add a new language to the project.

⚠️ Important Note on Context

POEditor uses the combination of term + context as a unique identifier. If a term is created with a context value, you must provide the same context when adding or updating translations for that term. Otherwise, POEditor will not be able to match the translation to the correct term.

📄 License

This project is licensed under the MIT license.