Skip to content

Connect Codex to Pear MCP

Connect Codex to Pear's hosted MCP server so your coding workflow can also work across Apple iCloud and Microsoft 365 Calendar, Tasks, Contacts, and Mail. Pear gives Codex live productivity context for release planning, follow-up tasks, scheduling, and inbox checks.

2 min setupBearer token env varCodex CLI

1. Create your Pear account

Sign up at pearmcp.com, connect Apple iCloud or Microsoft 365, then copy your Pear API key from Settings. Codex uses a Bearer token environment variable for remote HTTP MCP servers, so your key does not need to be hardcoded into the Codex config.

Sign Up Free

2. Add Pear in Codex CLI

Run this once from a shell where PEAR_API_KEY is set. Codex stores the MCP server entry globally in its config and reads the token from the environment when it connects.

export PEAR_API_KEY="YOUR_API_KEY"
codex mcp add pear --url "https://pearmcp.com/api/mcp" --bearer-token-env-var PEAR_API_KEY
codex mcp list

3. Verify it before a work session

Use codex mcp list to confirm Pear is registered. If your shell profile does not export PEAR_API_KEY, export it again before launching Codex.

For debugging, codex mcp add --help should show--url and--bearer-token-env-var options for Streamable HTTP MCP servers.

If you use Codex Desktop as well as Codex CLI, keep the CLI command as the source of truth for this setup. Desktop-managed MCP config can differ by release, while this CLI path binds Pear to an environment-backed token.

Useful Codex prompts

  • Check my calendar before planning this deploy window.
  • Create reminders for the release follow-ups in this TODO list.
  • Find a free 30-minute slot next week and draft an email to confirm it.
  • Search recent mail from this vendor before I update the integration docs.

What Pear unlocks inside Codex

  • Read and update calendar events, tasks, contacts, and mail from the same coding assistant.
  • Turn TODO comments, release notes, and planning docs into real reminders and follow-ups.
  • Check availability before scheduling work with teammates or customers.
  • Keep Apple iCloud and Microsoft 365 context available without writing local automation scripts.

Codex workflows worth testing

  • Ask Codex to create release follow-up reminders while it updates a changelog.
  • Have Codex check your calendar before scheduling a migration or customer call.
  • Let Codex search recent mail from a vendor before editing integration code or docs.

Ready to connect?

Free tier includes every current Pear MCP tool and 50 API calls/month.

Get Started Free

Other setup guides

ClaudeChatGPTGrokHermesCursorWindsurfClineOpenClawPoke