Skip to content
Folk client guide

Connect Folk to Pear MCP

Add Pear as a custom MCP server in Folk, then use your calendar, tasks, contacts, and mail from the conversation.
Custom MCPAPI keyReload commandBearer API keyRemote MCPSetup guide available

Connection details

The values Folk asks for first.

Pear hosted endpoint
https://pearmcp.com/api/mcp
Authentication
Bearer API key
Setup surface
Custom MCP server

Folk documents custom MCP servers configured with a name, URL, and key.

Setup documentation

Setup guide available

Official setup reference

1. Prepare Pear

Connect Apple iCloud or Microsoft 365 in Pear, then generate a Pear API key. Keep the key ready for Folk's custom MCP connection form.

Connect Pear and get an API key

2. Add Pear as a custom MCP server

Open Folk, go to Settings → Connections, and add a custom MCP server. Enter these values in Folk's name, URL, and key fields.

Name

Pear

Key

Your Pear API key

Server URL

https://pearmcp.com/api/mcp

Paste the Pear API key itself into Folk's key field. Do not use an Apple app-specific password, a Microsoft token, or an OAuth client credential here.

Read Folk's MCP instructions

3. Reload Folk and test a safe read

Save the connection. Folk says connected tools load automatically; if Pear does not show up yet, send /reload-mcp in your Folk conversation.

  • Ask Folk to check the status of your Pear connections.
  • Ask what is on tomorrow's calendar.
  • Look up a contact before combining it with a scheduling request.
  • Search unread mail, then draft a reply for review before sending.

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
Folk + Pear

Put Folk 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.