Create a workspace API key
- In Pharen, open Settings → Personal → API and select New API Key. Your workspace role needs permission to create API keys.
- Set the access target to Entire workspace. MCP requires a workspace key. Keys limited to Selected teams are rejected.
- Grant the permissions the AI tool needs. For the example below, choose Read for Lists (
lists:read). - Copy the
phk_key when Pharen displays it. MCP uses the same Pharen API keys as the REST API. The tool can use actions permitted by both the key and the person who created it.
Set up Codex
Use the Codex CLI in Bash or Zsh. Run the commands below and paste your key when prompted. The terminal hides the key as you enter it.PHAREN_MCP_TOKEN is set. For a different Pharen instance, use the server address shown in its API settings.
Use this read-only prompt to check the connection.
Show up to five Pharen lists that this key can read.Pharen exposes
search to find available actions and execute to call them. An agent can chain several actions in a single execute call.
Connect another MCP client
Add an MCP server with Streamable HTTP transport. Usehttps://pharen.app/api/mcp as the server address and provide the workspace API key as a Bearer token in the Authorization header.