# Pear MCP AI-readable docs

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

## Machine-readable discovery

- [Curated llms.txt overview](https://pearmcp.com/llms.txt)
- [MCP tools reference](https://pearmcp.com/llm/mcp-tools.md)
- [Client compatibility and support status](https://pearmcp.com/llm/mcp-compatibility.md)
- [Pricing](https://pearmcp.com/llm/pricing.md)
- [Workflow examples](https://pearmcp.com/llm/examples.md)
- [Data handling](https://pearmcp.com/llm/data-handling.md)
- [Public authentication guide](https://pearmcp.com/auth.md)
- [RFC 9727 API catalog](https://pearmcp.com/.well-known/api-catalog)
- [RFC 9728 protected-resource metadata](https://pearmcp.com/.well-known/oauth-protected-resource/api/mcp)
- [OpenAPI description](https://pearmcp.com/openapi.json)
- [Agent Skills draft discovery index](https://pearmcp.com/.well-known/agent-skills/index.json)

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

A setup guide documents configuration; it does not by itself prove that Pear supports or has tested that exact client surface.

| Client surface | Pear support status | Authentication | Setup guide |
| --- | --- | --- | --- |
| ChatGPT custom app | Setup documented; client-specific use unverified | OAuth client metadata document | Setup guide available |
| Claude hosted remote connector | Setup documented; client-specific use unverified | OAuth client metadata document | Setup guide available |
| Claude Code | Setup documented; client-specific use unverified | API key via environment | Setup guide available |
| Codex CLI | Setup documented; client-specific use unverified | API key via environment | Setup guide available |
| Codex in ChatGPT desktop app | Setup documented; client-specific use unverified | API key via environment | Setup guide available |
| Cursor | Setup documented; client-specific use unverified | OAuth with a registered Client ID | Setup guide available |
| Cursor Cloud Agents | Setup documented; client-specific use unverified | OAuth with a registered Client ID | Setup guide available |
| Devin Desktop / Cascade (Windsurf legacy config) | Setup documented; client-specific use unverified | API key via environment | Setup guide available |
| Cline | Setup documented; client-specific use unverified | API key | Setup guide available |
| VS Code Copilot | Setup documented; client-specific use unverified | API key via environment | Setup guide available |
| GitHub Copilot CLI | Setup documented; client-specific use unverified | API key | Setup guide available |
| Gemini CLI | Setup documented; client-specific use unverified | API key via environment | Setup guide available |
| Continue | Setup documented; client-specific use unverified | API key via environment | Setup guide available |
| Grok web | Setup documented; client-specific use unverified | OAuth with a registered Client ID | Setup guide available |
| Grok Bot | Not currently supported; client-specific use unverified | OAuth with a registered Client ID | Setup guide available |
| Grok Build | Setup documented; client-specific use unverified | API key via environment | Setup guide available |
| xAI API | Setup documented; client-specific use unverified | API key | Setup guide available |
| Hermes Agent | Setup documented; client-specific use unverified | API key via environment | Setup guide available |
| Poke | Setup documented; client-specific use unverified | API key | Setup guide available |
| Folk | Setup documented; client-specific use unverified | API key | Setup guide available |
| OpenClaw skill | External skill path | External skill | Setup guide available |
| Generic local MCP client | Setup documented; client-specific use unverified | API key via environment | No public setup guide |
| OpenCode | Setup documented; client-specific use unverified | API key via environment | Setup guide available |
| Kiro IDE | Setup documented; client-specific use unverified | API key via environment | Setup guide available |
| Perplexity | Setup documented; client-specific use unverified | API key | Setup guide available |
| LiveKit Agents | Setup documented; client-specific use unverified | API key via environment | Setup guide available |
| ElevenLabs Agents | Setup documented; client-specific use unverified | API key | Setup guide available |
<!-- MCP_HOST_SUMMARY:END -->

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

- [MCP client compatibility](./mcp-compatibility.md)
- [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)
- [iCloud Mail with Claude and other AI clients](./ai-icloud-mail.md)
- [iCloud Contacts MCP server](./icloud-contacts-mcp.md)
- [Microsoft 365 MCP server](./microsoft-365-mcp-server.md)
- [Outlook Mail MCP server](./outlook-mail-mcp.md)
- [Microsoft To Do MCP server](./microsoft-to-do-mcp.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)
- [Folk guide](./guide-folk.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.

## Canonical product references

- [Pear MCP tools reference](https://pearmcp.com/mcp-tools) — server-rendered from Pear's canonical hosted-tool catalogue.
- [Pear MCP compatibility](https://pearmcp.com/mcp-compatibility) — maintained client-guide, authentication, transport, provider-state, and workflow paths.

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.

- [OpenCode MCP guide](https://pearmcp.com/llm/guide-opencode.md): Configure Pear in OpenCode v1 or v2 with an environment-backed API key for iCloud and Microsoft 365. Setup documented; host testing remains open.

- [Kiro IDE MCP guide](https://pearmcp.com/llm/guide-kiro.md): Set up Pear in Kiro IDE with remote MCP and an approved API-key environment variable. Includes provider checks and troubleshooting.

- [GitHub Copilot CLI MCP guide](https://pearmcp.com/llm/guide-github-copilot-cli.md): Add Pear to GitHub Copilot CLI with a private HTTP configuration for iCloud and Microsoft 365. Includes tool filters and setup checks.

- [Perplexity MCP guide](https://pearmcp.com/llm/guide-perplexity.md): Check Perplexity remote MCP access, admin permissions, and Pear authentication requirements. The Pear connection is not yet verified.

## Humanoid robot development

These are custom development guides, not verified hardware integrations.

- [Humanoid robots](https://pearmcp.com/llm/guide-humanoid-robots.md)
- [Unitree G1 EDU](https://pearmcp.com/llm/guide-unitree-g1.md)
- [Booster K1 / T1](https://pearmcp.com/llm/guide-booster.md)
