> ## Documentation Index
> Fetch the complete documentation index at: https://developers.phrase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Phrase MCP Server

> Use Phrase APIs from any MCP client with ready-to-use tools for Phrase Strings and Phrase TMS.

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**.

<Card title="phrase/phrase-mcp-server" icon="github" href="https://github.com/phrase/phrase-mcp-server">
  View the source code, report issues, and contribute on GitHub.
</Card>

## 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

<Warning>
  **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.
</Warning>

Use the published package with `npx` in your MCP client configuration.

<CodeGroup>
  ```json Claude Desktop (claude_desktop_config.json) theme={null}
  {
    "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"
        }
      }
    }
  }
  ```

  ```toml Codex (~/.codex/config.toml) theme={null}
  [mcp_servers.phrase]
  command = "npx"
  args = ["-y", "@phrase/phrase-mcp-server"]

  [mcp_servers.phrase.env]
  PHRASE_STRINGS_TOKEN = "your_token"
  PHRASE_TMS_TOKEN = "your_token"
  PHRASE_ENABLED_PRODUCTS = "strings,tms"
  PHRASE_REGION = "eu"
  ```
</CodeGroup>

Set at least one product token in your MCP client configuration:

| Setup         | Required environment variables                              |
| ------------- | ----------------------------------------------------------- |
| Strings only  | `PHRASE_STRINGS_TOKEN`, `PHRASE_REGION`                     |
| TMS only      | `PHRASE_TMS_TOKEN`, `PHRASE_REGION`                         |
| Strings + TMS | `PHRASE_STRINGS_TOKEN`, `PHRASE_TMS_TOKEN`, `PHRASE_REGION` |

<Note>For support, please [open an issue on GitHub](https://github.com/phrase/phrase-mcp-server/issues) or [submit a request](https://support.phrase.com/hc/requests/new) via Phrase Help Center.</Note>

## Configuration reference

### Product selection

| Variable                   | Description                             | Default              |
| -------------------------- | --------------------------------------- | -------------------- |
| `PHRASE_ENABLED_PRODUCTS`  | Comma-separated subset of `strings,tms` | All products enabled |
| `PHRASE_DISABLED_PRODUCTS` | Products removed from the enabled set   | None                 |

### Region

| Variable        | Description  | Default |
| --------------- | ------------ | ------- |
| `PHRASE_REGION` | `eu` or `us` | `eu`    |

### Authentication

The server uses [Phrase Platform API tokens](/en/api/platform/authentication). Create API tokens in your Phrase account and provide them as environment variables to the MCP server.

| Variable               | Description                 |
| ---------------------- | --------------------------- |
| `PHRASE_STRINGS_TOKEN` | API token for Strings tools |
| `PHRASE_TMS_TOKEN`     | API token for TMS tools     |

<Tip>
  Use a dedicated service user token for automation and prefer least-privilege project manager permissions over admin-level roles.
</Tip>