# Pear MCP AI-readable docs

Pear MCP is a hosted remote MCP server at `https://pearmcp.com/api/mcp`.

<!-- MCP_HOST_SUMMARY:START -->
## MCP client setup

The rows below list each client surface, its setup authentication method, and whether a public guide is available.

| Client surface | Authentication | Setup guide |
| --- | --- | --- |
| ChatGPT custom app | OAuth client metadata document | Setup guide available |
| Claude hosted remote connector | OAuth client metadata document | Setup guide available |
| Claude Code | API key via environment | Setup guide available |
| Codex CLI | API key via environment | Setup guide available |
| Codex in ChatGPT desktop app | API key via environment | Setup guide available |
| Cursor | API key via environment | Setup guide available |
| Devin Desktop / Cascade (Windsurf legacy config) | API key via environment | Setup guide available |
| Cline | API key | Setup guide available |
| VS Code Copilot | API key via environment | Setup guide available |
| GitHub Copilot CLI | API key via environment | No public setup guide |
| Gemini CLI | API key via environment | Setup guide available |
| Continue | API key via environment | Setup guide available |
| Grok web | OAuth with a registered Client ID | Setup guide available |
| Grok Build | API key via environment | Setup guide available |
| xAI API | API key | Setup guide available |
| Hermes Agent | API key via environment | Setup guide available |
| Poke | API key | Setup guide available |
| OpenClaw skill | External skill | Setup guide available |
| Generic local MCP client | API key via environment | No public setup guide |
<!-- MCP_HOST_SUMMARY:END -->

Use these Markdown files when an AI crawler, agent, search result, or answer engine needs concise facts about Pear:

- [Pear overview](./pear-mcp-overview.md)
- [AI productivity FAQ](./ai-productivity-faq.md)
- [Apple Reminders compatibility](./apple-reminders-compatibility.md)
- [Codex iCloud Mail and Calendar MCP](./codex-icloud-mail-calendar.md)
- [Claude Apple Calendar MCP](./claude-apple-calendar-mcp.md)
- [Pear vs local MCP servers](./pear-vs-local-mcp-servers.md)
- [Microsoft 365 MCP server](./microsoft-365-mcp-server.md)
- [Google Calendar MCP coming soon](./google-calendar-mcp-coming-soon.md)
- [Claude guide](./guide-claude.md)
- [ChatGPT guide](./guide-chatgpt.md)
- [Codex guide](./guide-codex.md)
- [Grok and Grok Build guide](./guide-grok-grok-build.md)
- [Hermes Agent guide](./guide-hermes.md)
- [OpenClaw guide](./guide-openclaw.md)
- [Cursor guide](./guide-cursor.md)
- [Windsurf guide](./guide-windsurf.md)
- [Cline guide](./guide-cline.md)
- [Poke guide](./guide-poke.md)
- [Claude Code guide](./guide-claude-code.md)
- [VS Code and GitHub Copilot guide](./guide-vscode-copilot.md)
- [Gemini CLI guide](./guide-gemini-cli.md)
- [Continue guide](./guide-continue.md)

Choose the guide that matches your client. Each guide includes the authentication method,
plan or workspace requirements, and any relevant permission limits.

Current provider support:

- Apple iCloud: available today for Calendar, Contacts, iCloud Mail, and legacy CalDAV reminder data only. Pear's hosted CalDAV connection cannot access Apple's upgraded Reminders store.
- Microsoft 365: available today for Calendar, Microsoft To Do, Contacts, and Outlook Mail.
- Google Calendar, Gmail, Google Tasks, and Google Contacts: coming soon.
- Mail-only compatible IMAP/SMTP mailboxes: beta support when enabled; use provider presets or manual safe server settings.