Skip to content
Claude Code client guide

Connect Claude Code to Pear MCP

Add Pear as a remote HTTP MCP server and keep your API key in the local environment or secret manager.
Quick setupTerminal workflowAPI keyBearer API keyRemote MCPSetup guide available

Connection details

The values Claude Code asks for first.

Pear hosted endpoint
https://pearmcp.com/api/mcp
Authentication
Bearer API key
Setup surface
Claude Code MCP config

Claude Code documents remote MCP, headers, static clients, and automatic CIMD discovery when DCR is unavailable.

Setup documentation

Setup guide available

Official setup reference

1. Prepare Pear

Create a Pear account, connect Apple iCloud or Microsoft 365, then copy your hosted MCP endpoint and API key. Claude Code's official MCP docs recommend remote HTTP servers for cloud services like Pear.

Start Free

Apple Reminders compatibility

Apple Reminders availability depends on the Apple account. For Apple, Pear can read and write only the legacy reminder lists Apple still exposes through CalDAV. If the account has been upgraded to Apple's newer Reminders store, Pear cannot access those native lists and does not copy them into a separate reminder store. Apple may instead return compatibility placeholders, such as repeated "Where are my reminders?" items; Pear did not create them. Pear's safe fallback hides known placeholders and blocks writes to affected lists. Reconnecting iCloud or replacing the App-Specific Password will not change this Apple limitation. Calendar, Contacts, and Mail are unaffected, and Microsoft To Do uses Microsoft Graph and is unaffected. Full modern Apple Reminders access would require an Apple-platform companion using EventKit with the user's permission; Pear does not currently provide one.

Read the Apple Reminders compatibility note

2. Register Pear

Add Pear as a remote HTTP MCP server. The user scope makes Pear available across your Claude Code projects without committing a token to the repo.

Make PEAR_API_KEY available to the Claude Code process through your local environment or secret manager before running this command. The command stores a literal environment reference, not the key itself.

claude mcp add --transport http --scope user \
  --header 'Authorization: Bearer ${PEAR_API_KEY}' \
  pear https://pearmcp.com/api/mcp
claude mcp list

Use the environment-backed API-key setup above for Pear. Restart Claude Code or refresh its MCP servers after changing the configuration.

3. Use Pear carefully in coding sessions

  • Ask Claude Code to inspect available Pear tools before calling write actions.
  • Use read prompts first: calendar availability, recent mail, or contact lookup.
  • Confirm create/update/delete actions in the conversation before letting the agent act.
  • Regenerate your Pear key if it appears in terminal history or a repository file.
Claude Code + Pear

Put Claude Code to work across your providers.

Free includes 50 counted provider actions/month; Pro removes the cap.