# Raycast MCP setup for iCloud Calendar and Outlook

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

Use the authentication method shown for each client surface.

| Client surface | Authentication | Setup guide |
| --- | --- | --- |
| Raycast | API key | Setup guide available |
<!-- MCP_HOST_COMPATIBILITY:END -->

Use Pear tools from Raycast AI with your connected iCloud or Microsoft 365 account. Raycast 1.98 or later is required, and iOS is HTTP-only.

## 1. Prepare the account

[Sign in to Pear](https://pearmcp.com/login), connect iCloud or Microsoft 365, and create an API key in Settings. You need Raycast AI. Requests still go to Pear's hosted endpoint.

## 2. Install an HTTP MCP server

Run the Install MCP Server command. Choose HTTP. Leave the OAuth fields empty. Raycast Dynamic OAuth expects the server to register a client automatically, and Pear does not offer that.

```text
Transport: HTTP
URL: https://pearmcp.com/api/mcp
HTTP header name: Authorization
HTTP header value: Bearer YOUR_PEAR_API_KEY
```

Replace the placeholder in Raycast's private server form. Keep the `Bearer ` prefix. Do not paste the key into a Raycast AI chat.

## 3. Verify a real tool result

Ask Raycast AI to call `pear_provider_status` and name the ready services for the expected account. Then find a known calendar event in a narrow date range and your timezone. Inspect the actual tool response: describing a proposed calendar check is not a completed read.

After the read, try: “Find tomorrow's planning meeting and summarize its time and attendees. Then preview a follow-up email for me to review; do not send it.” Review the draft, recipients, and sending account before approving a write through Pear.

## Troubleshooting and revocation

If Raycast opens a browser sign-in, the OAuth fields were filled or the header was omitted. Clear OAuth and set the Authorization header instead. For provider errors, check the connected account in Pear.

Revoke the API key in Pear to end access, then remove the Raycast server or replace the header value.

## Provider limits and next steps

Tools depend on your connected provider, account permissions, and client settings. Start with a read, then inspect a preview before approving writes.

- [iCloud setup](https://pearmcp.com/icloud-mcp-server)
- [iCloud Mail](https://pearmcp.com/ai-icloud-mail)
- [Microsoft 365 setup](https://pearmcp.com/microsoft-365-mcp-server)
- [Outlook Mail](https://pearmcp.com/outlook-mail-mcp)
- [Microsoft To Do](https://pearmcp.com/microsoft-to-do-mcp)
- [Data handling](https://pearmcp.com/data-handling)
- [Plans](https://pearmcp.com/pricing)

Pear's hosted CalDAV connection cannot access Apple's upgraded Reminders store. Only legacy reminder data still exposed through CalDAV is available; reconnecting cannot change this limit. Microsoft To Do is unaffected. Google Workspace is coming soon.

## Sources and compatibility status

Documentation checked on 26 September 2026. Setup guide available; a complete Pear authentication, tool-list, read, and approved-write test in Raycast is still pending.

- [Official Raycast MCP manual](https://manual.raycast.com/ai/model-context-protocol)
- [HTML setup guide](https://pearmcp.com/guides/raycast)