iconnect-mcp

List all notes with title, folder, and dates. Optionally filter by folder name. Supports pagination via limit/offset.

Search notes by keyword in title and body. Returns matching notes with a 200-char preview.

Read the full content of a specific note by its ID. Returns HTML body and plaintext.

Create a new note with HTML body. The first line of the body becomes the note title automatically. Optionally specify a target folder.

Replace the entire body of an existing note. WARNING: This overwrites all content. Read the note first if you need to preserve parts of it. Attachments may be lost.

Delete a note by ID. The note is moved to Recently Deleted and permanently removed after 30 days.

List all folders across all accounts with note counts.

Create a new folder. Optionally specify which account to create it in.

Move a note to a different folder. NOTE: Apple Notes has no native move command, so this copies the note body to the target folder and deletes the original. The note will get a new ID and creation date. Attachments (images) will be lost.

Bulk scan notes returning metadata and a text preview for each. Supports pagination via offset. Optionally filter by folder. Use this to get an overview before organizing.

Retrieve full plaintext content of 2-5 notes at once for comparison. Use this after scan_notes to safely compare potentially duplicate or similar notes before deciding what to keep, merge, or delete.

Move multiple notes to a target folder at once. Same limitations as move_note apply to each note (new ID, date reset, attachments lost). Returns per-note success/failure results.

List all reminder lists with reminder counts.

List reminders. Optionally filter by list name and/or completion status. Supports pagination via limit/offset.

Read the full details of a specific reminder by ID.

Create a new reminder. Optionally set notes, due date, priority (0=none, 1-4=high, 5=medium, 6-9=low), and target list. Recurrence rules cannot be set via automation.

Update reminder properties. Only specified fields are changed. Set dueDate to null to clear it. Recurrence rules cannot be modified via automation.

Mark a reminder as completed or un-complete it.

Delete a reminder by ID. This action is permanent.

Search reminders by keyword in name or body across all lists (case-insensitive).

Create a new reminder list.

Delete a reminder list by name. This action is permanent and removes all reminders in the list.

Create a recurring reminder via EventKit. Supports daily, weekly, monthly, and yearly recurrence with configurable intervals. Requires macOS 26+ Swift bridge.

List all calendars with name, color, and writable status.

List events within a date range. Requires startDate and endDate (ISO 8601). Optionally filter by calendar name. Supports limit/offset pagination.

Read full details of a calendar event by ID. Includes attendees (read-only), location, description, and recurrence info.

Create a new calendar event. Recurring events cannot be created via automation. Attendees cannot be added programmatically.

Update event properties. Only specified fields are changed. Attendees and recurrence rules cannot be modified via automation.

Delete a calendar event by ID. This action is permanent.

Search events by keyword in title or description within a date range.

Get the next N upcoming events from now (searches up to 30 days ahead). A convenience wrapper that doesn't require date range parameters.

Get all calendar events for today.

Create a recurring calendar event via EventKit. Supports daily, weekly, monthly, and yearly recurrence with configurable intervals. Requires macOS 26+ Swift bridge.

Read the current text content of the system clipboard.

Write text to the system clipboard, replacing its current content.

Get the current system output volume level and mute state.

Set the system output volume (0-100) and/or mute state.

Toggle macOS appearance between dark mode and light mode.

Get the name, bundle identifier, and PID of the currently active (frontmost) application.

List all running applications with name, bundle identifier, PID, and visibility.

Get display information including resolution, pixel dimensions, and Retina status.

Display a macOS system notification with optional title, subtitle, and sound.

Take a screenshot and save to the specified path. Supports full screen, window, or selection capture.

List all available Siri Shortcuts on this Mac.

Run a Siri Shortcut by name. Optionally provide text input. Returns the shortcut's output. Note: shortcuts may trigger UI prompts or perform system actions.

Search Siri Shortcuts by name keyword.

Get details about a Siri Shortcut including its actions.

Create a new Siri Shortcut by name. Uses UI automation to open the Shortcuts app and create a new empty shortcut. The shortcut must be further configured in the Shortcuts app.

Delete a Siri Shortcut by name. Uses the macOS shortcuts CLI (macOS 13+). This action is permanent and cannot be undone.

Export a Siri Shortcut to a .shortcut file. Uses the macOS shortcuts CLI to save the shortcut to the specified output path.

Import a .shortcut file into Siri Shortcuts. Uses the macOS shortcuts CLI to import the shortcut from the specified file path.

Duplicate an existing Siri Shortcut. Exports the shortcut to a temporary file and re-imports it with a new name.

Open a Siri Shortcut in the Shortcuts app for manual editing. Uses UI automation (System Events) to activate the app, search for the shortcut, and open it. The user can then edit the shortcut in the Shortcuts app UI.

Collect context from all enabled Apple apps and ask the client's LLM to produce a concise briefing. Uses MCP Sampling — works with any LLM the client is using. No API keys required.

Index data from enabled Apple apps (Notes, Calendar, Reminders, Mail) into the local vector store for semantic search. Run this once, then use semantic_search. Requires Swift bridge (npm run swift-build).

Search across Apple app data by meaning, not just keywords. Finds related notes, events, reminders, and emails even if they use different words. Auto-indexes on first use and refreshes every 30 minutes.

Given a note, event, reminder, or email ID, find semantically related items across all indexed Apple apps. Discovers cross-app connections (e.g., a calendar event related to notes and reminders about the same topic).

Show the current state of the semantic vector index -- total entries, breakdown by source.

Trigger macOS permission prompts for all Apple apps used by iConnect. Run this once after installation to grant all permissions at once. Each app will show a one-time macOS permission dialog.

Retrieve a registered MCP prompt by name and return its workflow instructions as text. Useful in autonomous/Cowork environments where prompts cannot be invoked directly.