# Warp MCP setup for iCloud Calendar and Outlook

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

Use the authentication method shown for each client surface.

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

Use Pear tools from Warp with your connected iCloud or Microsoft 365 account. Warp needs a version that supports Streamable HTTP custom headers.

## 1. Prepare the account

[Sign in to Pear](https://pearmcp.com/login), connect iCloud or Microsoft 365, and create an API key in Settings. Use a current Warp release with Streamable HTTP servers and custom headers.

## 2. Add a remote MCP server

Open Settings → Agents → MCP servers, click + Add, and paste this JSON. Warp documents the `mcpServers` wrapper for importing named servers. Keep the key in your personal configuration.

```json
{
  "mcpServers": {
    "pear": {
      "url": "https://pearmcp.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_PEAR_API_KEY"
      }
    }
  }
}
```

Replace the placeholder with your Pear key. Keep the `Bearer ` prefix. Do not paste the completed header into a Warp conversation or a shared config.

## 3. Verify a real tool result

Ask Warp 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

For authentication errors, check the URL and the Authorization header. For provider errors, check the connected account in Pear.

Revoke the API key in Pear to end access, then remove the Warp server entry 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 4 October 2026. Setup guide available; a complete Pear authentication, tool-list, read, and approved-write test in Warp is still pending.

- [Official Warp MCP documentation](https://docs.warp.dev/agents/capabilities/mcp/)
- [HTML setup guide](https://pearmcp.com/guides/warp)