# Claude Code + Pear MCP guide

<!-- MCP_HOST_IDS: claude-code -->
<!-- MCP_HOST_COMPATIBILITY:START -->
## Connection and authentication

Use the authentication method shown for each client surface.

| Client surface | Authentication | Setup guide |
| --- | --- | --- |
| Claude Code | API key via environment | Setup guide available |
<!-- MCP_HOST_COMPATIBILITY:END -->

Add Pear to Claude Code as a remote HTTP MCP server for Apple Calendar, Contacts,
iCloud Mail, and legacy CalDAV reminder data, plus Microsoft 365 Calendar, Microsoft
To Do, Contacts, and Outlook Mail workflows.

Pear's hosted CalDAV connection cannot access Apple's upgraded Reminders store.
Microsoft To Do uses Microsoft Graph and is unaffected. See the
[Apple Reminders compatibility note](./apple-reminders-compatibility.md).

Server URL:

```text
https://pearmcp.com/api/mcp
```

## Setup

1. Create a Pear account and connect Apple iCloud or Microsoft 365.
2. Make `PEAR_API_KEY` available to the Claude Code process through your local
   environment or secret manager before running the command; do not commit it to
   a repository.
3. Register Pear at user scope:

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

The single-quoted header deliberately passes a literal environment reference,
not the key itself. Claude Code documents environment-variable expansion for MCP
configuration in its
[official MCP guide](https://code.claude.com/docs/en/mcp#environment-variable-expansion-in-mcpjson).

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

Start with `pear_provider_status` or another read-only request. Review create, update,
send, move, or delete actions before execution.