POEditor (Official)

Manage POEditor localization projects from your AI assistant: add terms, update translations, run QA checks, auto-translate, and manage glossaries.

Hosted MCP Server

npx add-mcp 'https://mcp.poeditor.com/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Official POEditor MCP Server

License: MIT MCP POEditor

Official Model Context Protocol (MCP) server for POEditor — the translation management platform. Connect any MCP-compatible AI assistant directly to your POEditor projects.

59 tools across the full POEditor v2 API. Manage projects, terms, translations, contributors, and languages. Maintain glossaries. Auto-translate with Google, Microsoft, or DeepL. Round-trip text with Figma. Export to any format your client supports. OAuth 2.1 with PKCE.


Endpoint

https://mcp.poeditor.com/mcp

Official remote MCP server, hosted by POEditor. No installation required. Streamable HTTP transport, MCP spec compliant.


Quick start

1. Get your API token

Generate a token at poeditor.com/account/api.

2. Add to your client

Claude Code — OAuth or API token:

claude mcp add poeditor --transport http https://mcp.poeditor.com/mcp

On first use Claude Code opens a browser for POEditor login and stores the token automatically. To use an API token instead:

claude mcp add poeditor --transport http https://mcp.poeditor.com/mcp \
  --header "Authorization: Bearer YOUR_POEDITOR_API_TOKEN"

Claude Desktop — edit claude_desktop_config.json:

{
  "mcpServers": {
    "poeditor": {
      "url": "https://mcp.poeditor.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_POEDITOR_API_TOKEN"
      }
    }
  }
}

Cursor — edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "poeditor": {
      "url": "https://mcp.poeditor.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_POEDITOR_API_TOKEN"
      }
    }
  }
}

Windsurf — edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "poeditor": {
      "serverUrl": "https://mcp.poeditor.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_POEDITOR_API_TOKEN"
      }
    }
  }
}

VS Code (GitHub Copilot) — add to .vscode/mcp.json:

{
  "servers": {
    "poeditor": {
      "url": "https://mcp.poeditor.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_POEDITOR_API_TOKEN"
      }
    }
  }
}

Zed — add to ~/.config/zed/settings.json:

{
  "context_servers": {
    "poeditor": {
      "command": {
        "path": "npx",
        "args": [
          "-y", "mcp-remote",
          "https://mcp.poeditor.com/mcp",
          "--header", "Authorization: Bearer YOUR_POEDITOR_API_TOKEN"
        ]
      },
      "settings": {}
    }
  }
}

Gemini CLI — add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "poeditor": {
      "url": "https://mcp.poeditor.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_POEDITOR_API_TOKEN"
      }
    }
  }
}

Amazon Q Developer — add to ~/.aws/amazonq/mcp.json:

{
  "mcpServers": {
    "poeditor": {
      "url": "https://mcp.poeditor.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_POEDITOR_API_TOKEN"
      }
    }
  }
}

See examples/ for Cline, Continue, Augment, and other client configurations.

3. Try it

Ask your assistant:

List all my POEditor projects

Tools

The live tool list is served by the MCP endpoint via tools/list. Categories below reflect current coverage.

CategoryTools
Projectslist, details, add, update, delete, sync, upload, export
Languagesavailable languages, list project languages, add, update, delete
Termslist, add, update, delete, details, comment
Translationscommit, propose, update, delete, fill from TM, list fuzzy, list pending proofread, list untranslated, mark proofread
Progresstranslation status, proofread progress, project activity stats
QualityQA checks, AI quality evaluation (MQM scoring), list stored evaluations
Contributorslist, add, remove, contributor activity stats
Glossarieslist, details, add, update, delete, assign/unassign to projects, list/add/update/delete terms, set/delete translations, CSV import/export
Automationautomatic translation (Google, Microsoft, DeepL)
Figmaexport page to POEditor, import translations as Figma variables, remove localization collection, remove obsolete terms
Accountaccount info

Full schema: see docs/tools.md.


Authentication

  • Token — POEditor API token, passed as Authorization: Bearer <token> header
  • OAuth 2.1 (PKCE) — supported for one-click connect in Claude Code, Claude.ai Connectors, and compatible clients

Token scope: user's own projects only. No cross-tenant access. See Authentication.


Export formats

export_strings_file returns a download URL for the generated file. Any format POEditor supports can be requested — the LLM can read, parse, and work with the content directly regardless of format. See docs/tools.md for the full format list.


Examples

List all my POEditor projects
Show me untranslated terms in project 123456 for Spanish
Add the term "checkout_button" with English value "Check out" to project 123456
Export Spanish translations from project 123456 as JSON
Auto-translate untranslated French terms in project 123456 using DeepL
Show translation progress for all languages in project 123456
List all contributors for project 123456
Add "Dashboard" as a do-not-translate term to my product glossary
How many words did each contributor translate in project 123456 last month?
Export the "Checkout" page from this Figma file into project 123456

Supported clients

Anything that speaks MCP. Works with:

  • Claude Code · Claude Desktop · Claude.ai Connectors
  • Cursor · Windsurf · Zed
  • VS Code (GitHub Copilot · Cline · Continue · MCP extension)
  • Gemini CLI · Amazon Q Developer · Augment
  • mcp-inspector

Features

  • 59 tools — full POEditor v2 API coverage plus tools beyond the raw API
  • Export to any format POEditor supports
  • Glossaries shared across projects, with CSV import/export
  • Automatic translation via Google, Microsoft, or DeepL
  • Figma round-trip via the user's own Figma MCP connection
  • OAuth 2.1 with PKCE
  • Streamable HTTP transport (MCP spec compliant)
  • ISO 27001 certified infrastructure

Links

License

MIT — see LICENSE.