Skip to content

Windsurf / legacy Cascade client guide

Connect Windsurf and legacy Cascade to Pear MCP

Use Pear from legacy Cascade in Devin Desktop or Windsurf. Keep the API key in your local environment; Devin Local has a separate configuration.

Connection details

The values Windsurf / legacy Cascade asks for first.

Pear hosted endpointhttps://pearmcp.com/api/mcp
Authentication
Bearer API key
Setup surface
Cascade mcp_config.json
Quick setupStreamable HTTPAPI keyStreamable HTTP

Devin documents remote MCP and environment-backed headers for legacy Cascade. This guide does not configure Devin Local or establish a verified Pear connection.

Setup guide availableOfficial setup reference

Choose the right Devin agent

This guide covers Cascade, the agent in Windsurf and older Devin Desktop tabs. Devin Local is the default agent for new Devin Desktop tabs and uses Devin CLI configuration instead. The example below does not configure Devin Local. Current Devin and Devin Local use the Devin setup guide. Cascade's own file format is documented in the official Cascade MCP documentation.

Get ready

1. Create your Pear account

Sign up at pearmcp.com and connect Apple iCloud or Microsoft 365. Make your private Pear API key available as PEAR_API_KEY in the environment that starts the editor. The configuration below references that variable; keep the key out of shared files.

Sign Up Free

Apple Reminders compatibility

Apple Reminders availability depends on the Apple account. For Apple, Pear can read and write only the legacy reminder lists Apple still exposes through CalDAV. If the account has been upgraded to Apple's newer Reminders store, Pear cannot access those native lists and does not copy them into a separate reminder store. Apple may instead return compatibility placeholders, such as repeated "Where are my reminders?" items; Pear did not create them. Pear's safe fallback hides known placeholders and blocks writes to affected lists. Reconnecting iCloud or replacing the App-Specific Password will not change this Apple limitation. Calendar, Contacts, and Mail are unaffected, and Microsoft To Do uses Microsoft Graph and is unaffected. Full modern Apple Reminders access would require an Apple-platform companion using EventKit with the user's permission; Pear does not currently provide one.

Read the Apple Reminders compatibility note
Make the connection

2. Add Pear in Cascade MCP settings

Open Cascade's Actions (…) menu, then Open MCP config file. Merge this Pear entry into mcp_config.json without replacing your other servers. Cascade has no marketplace or one-click install. Enterprise users must enable MCP manually; team allowlist controls can also block Pear.

{
  "mcpServers": {
    "pear": {
      "serverUrl": "https://pearmcp.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:PEAR_API_KEY}"
      }
    }
  }
}

Save the file and enable Pear in Cascade's server list. If authentication fails, check that the editor received PEAR_API_KEY; an unset variable becomes an empty value.

Check it works

3. Use Pear from Cascade

  • Ask Cascade to list MCP tools and confirm Pear is connected.
  • Try “Am I free at 3pm today?” as the first read-only test.
  • Review scheduling or task drafts before approving a write. Apple reminder writes require a usable legacy CalDAV list; Microsoft To Do is unaffected.
  • Keep Pear enabled only in workspaces that need productivity context.

Sources and connection status

Checked 26 September 2026 against the Devin Cascade MCP documentation. Pear's authenticated Cascade testing remains open. This guide does not establish Devin Local compatibility.

See Pear compatibility or compare AI assistants.

Related guides
All guides
Windsurf / legacy Cascade + Pear

Put Windsurf / legacy Cascade to work across your providers.

Free includes 50 counted provider actions/month. Most provider reads or writes count as one action. Batch writes count once per item. Setup and discovery do not count. Failed actions Pear can confirm had no provider effect also do not count; actions with an unknown outcome may count. Pro removes the cap.