Skip to main content
Use Phrase APIs from any MCP-compatible client such as Claude, Cursor, or Codex. The Phrase MCP Server provides ready-to-use tools for both Phrase Strings and Phrase TMS.

phrase/phrase-mcp-server

View the source code, report issues, and contribute on GitHub.

​
Who this is for

  • Localization managers automating routine project and job operations
  • Engineers building AI workflows around Phrase
  • Teams that want one MCP server for both Strings and TMS

​
Quick start

The npm package has been renamed. The package is now published under the @phrase organization as @phrase/phrase-mcp-server. If you are using the old phrase-mcp-server package, update your MCP client configuration to use @phrase/phrase-mcp-server instead.
Use the published package with npx in your MCP client configuration. 
{
  "mcpServers": {
    "phrase": {
      "command": "npx",
      "args": ["-y", "@phrase/phrase-mcp-server"],
      "env": {
        "PHRASE_STRINGS_TOKEN": "your_token",
        "PHRASE_TMS_TOKEN": "your_token",
        "PHRASE_ENABLED_PRODUCTS": "strings,tms",
        "PHRASE_REGION": "eu"
      }
    }
  }
}
Set at least one product token in your MCP client configuration:
SetupRequired environment variables
Strings onlyPHRASE_STRINGS_TOKEN, PHRASE_REGION
TMS onlyPHRASE_TMS_TOKEN, PHRASE_REGION
Strings + TMSPHRASE_STRINGS_TOKEN, PHRASE_TMS_TOKEN, PHRASE_REGION
For support, please open an issue on GitHub or submit a request via Phrase Help Center.

​
Configuration reference

​
Product selection

VariableDescriptionDefault
PHRASE_ENABLED_PRODUCTSComma-separated subset of strings,tmsAll products enabled
PHRASE_DISABLED_PRODUCTSProducts removed from the enabled setNone

​
Region

VariableDescriptionDefault
PHRASE_REGIONeu or useu

​
Authentication

The server uses Phrase Platform API tokens. Create API tokens in your Phrase account and provide them as environment variables to the MCP server.
VariableDescription
PHRASE_STRINGS_TOKENAPI token for Strings tools
PHRASE_TMS_TOKENAPI token for TMS tools
Use a dedicated service user token for automation and prefer least-privilege project manager permissions over admin-level roles.