iMCP Server for Mac: Setup for Claude, Claude Code and Other Apps

• Finds events in your calendar

  Lists calendar events by date range and other filters. Needs the Calendar service turned on in the iMCP menu.

  Try: “What is on my calendar next Tuesday?”

  Read · events_fetch

• Lists your calendars

  Shows the calendars on your Mac so the assistant can pick the right one.

  Try: “Which calendars do I have?”

  Read · calendars_list

• Adds an event to your calendar

  Creates an event with a title, time, location, repeat rule and alarms.

  Try: “Add lunch with Sam on Friday at noon, with a 15 minute alert.”

  Write · events_create

• Changes an existing calendar event

  Edits only the fields you name on an event. For a repeating event it changes the occurrence you point to.

  Try: “Move tomorrow's dentist appointment to 3 pm.”

  Write · events_update

• Deletes a calendar event

  Removes an event from your calendar. For a repeating event it removes the occurrence at the start date you give.

  Try: “Delete the team sync on Thursday.”

  Delete · events_delete

• Reads your own contact card

  Returns your own contact card so the assistant knows your details when you ask a personal question.

  Try: “What is my home address on file?”

  Read · contacts_me

• Finds contacts by name, phone or email

  Looks up people in your address book by name, number or email.

  Try: “Find Dana's phone number.”

  Read · contacts_search

• Lists your contacts

  Returns contacts in pages so the assistant can read a large address book.

  Try: “List my first 50 contacts.”

  Read · contacts_list

• Adds a new contact

  Saves a new person to your address book.

  Try: “Add Priya Shah, priya@example.com, as a contact.”

  Write · contacts_create

• Changes an existing contact

  Edits fields on a contact you already have. The tool is marked as destructive.

  Try: “Update Sam's phone number to 555-0102.”

  Write · contacts_update

• Reads your Messages history

  Pulls messages with chosen people over a date range from your Mac's Messages history.

  Try: “Summarize my messages with Alex from last week.”

  Files · messages_fetch

• Reads a file attached to a message

  Returns the file attached to a message as encoded data.

  Try: “Open the PDF Alex sent yesterday.”

  Files · messages_attachment_read

• Lists your Mail mailboxes

  Shows the mailboxes found in your Mail folder on this Mac.

  Try: “List my mailboxes.”

  Files · mail_mailboxes_list

• Searches your email by sender and subject

  Finds messages in your local Mail index by sender, subject, mailbox, date or read status. It does not search the message text.

  Try: “Find emails from billing@example.com this month.”

  Files · mail_messages_search

• Reads an email stored on your Mac

  Returns the content of one stored message. Attachments are listed but their content is not returned.

  Try: “Read that invoice email.”

  Files · mail_messages_read

• Opens a new draft in your email app

  Opens a draft in your default mail app with the recipient and text filled in. You send it yourself.

  Try: “Draft an email to the landlord about the broken heater.”

  Runs code · mail_compose

• Lists your reminder lists

  Shows the lists in Reminders.

  Try: “What reminder lists do I have?”

  Read · reminders_lists

• Finds reminders

  Lists reminders by list, due date, completion and other filters.

  Try: “What reminders are due this week?”

  Read · reminders_fetch

• Adds a reminder

  Makes a reminder with a due date, repeat rule, priority and alerts.

  Try: “Remind me to renew my passport on the 1st.”

  Write · reminders_create

• Changes a reminder

  Edits only the fields you name on a reminder.

  Try: “Move the passport reminder to next Monday.”

  Write · reminders_update

• Deletes a reminder

  Removes one reminder.

  Try: “Delete the reminder about the old invoice.”

  Delete · reminders_delete

• Creates a reminder list

  Adds a new list in Reminders.

  Try: “Create a list called Trip Prep.”

  Write · reminders_lists_create

• Renames a reminder list

  Changes a list's name. Marked as destructive.

  Try: “Rename Groceries to Weekly Shop.”

  Write · reminders_lists_rename

• Deletes a reminder list and all its reminders

  Removes a whole list and every reminder in it, with no undo.

  Try: “Delete the Old Projects list.”

  Delete · reminders_lists_delete

• Lists your Notes folders

  Shows your folders and how many notes each holds.

  Try: “What folders do I have in Notes?”

  Read · notes_folders

• Finds notes, newest first

  Lists notes by text, folder or date with a short preview.

  Try: “Find my notes about the kitchen remodel.”

  Read · notes_fetch

• Reads a full note

  Returns one note with its headings, lists, checklists, links and tables.

  Try: “Read my note called Packing List.”

  Read · notes_read

• Lists your recent phone calls

  Shows calls synced from your iPhone, filtered by person, date or type.

  Try: “Who called me yesterday?”

  Read · phone_calls_fetch

• Starts a phone call from your Mac

  Begins a call through your iPhone. macOS asks you to confirm before it dials.

  Try: “Call Mom.”

  Runs code · phone_call

• Lists your voicemails

  Shows voicemails from the inbox or another mailbox.

  Try: “Any new voicemails?”

  Files · voicemails_fetch

• Reads the transcript of a voicemail

  Returns the text of one voicemail.

  Try: “What did the doctor's voicemail say?”

  Files · voicemail_transcript_fetch

• Fetches the audio of a voicemail

  Returns the sound file of one voicemail.

  Try: “Get the audio of the latest voicemail.”

  Files · voicemail_audio_fetch

• Lists your Voice Memos recordings

  Shows your recordings by title, folder or date.

  Try: “List my voice memos from this week.”

  Files · voice_memos_fetch

• Reads the transcript of a voice memo

  Returns the text Voice Memos made of one recording.

  Try: “Transcribe my memo about the project ideas.”

  Files · voice_memo_transcript_fetch

• Fetches the audio of a voice memo

  Returns the sound file of one recording.

  Try: “Get the audio of my last voice memo.”

  Files · voice_memo_audio_fetch

• Gets where your Mac is now

  Returns your current location from macOS Location Services.

  Try: “Where am I right now?”

  Network · location_current

• Turns an address into coordinates

  Converts a street address to latitude and longitude.

  Try: “What are the coordinates of 1 Infinite Loop, Cupertino?”

  Network · location_geocode

• Turns coordinates into an address

  Finds the address for a latitude and longitude.

  Try: “What address is at 37.33, -122.03?”

  Network · location_reverse-geocode

• Searches Apple Maps for places

  Finds places and businesses by name or type.

  Try: “Find coffee shops near the Ferry Building.”

  Network · maps_search

• Gets driving or walking directions

  Returns route steps between two places by car or on foot.

  Try: “How do I walk from Union Square to Pier 39?”

  Network · maps_directions

• Finds points of interest near a place

  Lists nearby places of interest around a point.

  Try: “What is worth seeing near the Golden Gate Bridge?”

  Network · maps_explore

• Estimates travel time between two places

  Gives an estimated trip time, including transit.

  Try: “How long by transit from home to the airport?”

  Network · maps_eta

• Makes a map image

  Creates a still map picture for a location.

  Try: “Make a map image of downtown Portland.”

  Network · maps_generate

• Gets the current weather

  Returns temperature, wind and conditions for a place.

  Try: “What is the weather in Berlin right now?”

  Network · weather_current

• Gets the daily forecast

  Returns the day-by-day forecast.

  Try: “Give me the 7 day forecast for Seattle.”

  Network · weather_daily

• Gets the hourly forecast

  Returns the hour-by-hour forecast.

  Try: “Will it rain this afternoon?”

  Network · weather_hourly

• Gets the minute-by-minute forecast

  Returns very short-term rain and weather detail.

  Try: “When will the rain start?”

  Network · weather_minute

• Shows what is playing in Music

  Returns the current track.

  Try: “What song is playing?”

  Read · music_now_playing

• Controls Music playback

  Plays, pauses or skips in the Music app. Needs Automation permission for Music.

  Try: “Pause the music.”

  Runs code · music_control

• Searches the Apple Music catalog

  Finds songs, albums and artists. Needs Apple Music access.

  Try: “Find albums by Khruangbin.”

  Network · music_catalog_search

• Lists your Shortcuts

  Shows the names of the shortcuts you have.

  Try: “Which shortcuts do I have?”

  Read · shortcuts_list

• Runs a Shortcut by name

  Runs any shortcut on your Mac, with optional text as input. What happens depends on the shortcut, so it can do anything a shortcut can. It is marked destructive.

  Try: “Run my Morning Routine shortcut.”

  Runs code · shortcuts_run

• Takes a photo with the camera

  Captures a photo from your Mac's camera and returns it to the assistant.

  Try: “Take a picture of my desk.”

  Files · capture_take_picture

• Records audio with the microphone

  Records sound from your microphone and returns it.

  Try: “Record 10 seconds of audio.”

  Files · capture_record_audio

• Takes a screenshot

  Captures your screen, a window or an app and returns the image.

  Try: “Take a screenshot of the Safari window.”

  Files · capture_take_screenshot

• Plays a system sound

  Plays a sound on your Mac. It is always on, so you can test the connection without granting any permissions.

  Try: “Play a sound to test the connection.”

  Runs code · utilities_beep

Watch out for

• Only Maps is on at first; each service adds risk

  Turning on Messages, Mail, Notes, Contacts or Phone lets the assistant read private data. Switch on only what you need. github.com

• shortcuts_run can do anything a Shortcut can

  It runs any shortcut by name and is marked destructive. Leave Shortcuts off, or turn off that tool in Settings, unless you trust every shortcut you have. github.com

• It can delete calendar events and reminders

  events_delete, reminders_delete and reminders_lists_delete remove items, and deleting a list removes every reminder in it with no undo. Turn these tools off in Settings if you only want to read. github.com

• It can use the camera, microphone and screen

  capture_take_picture, capture_record_audio and capture_take_screenshot return what they capture to the AI app. Keep Capture off unless you need it. github.com

• Your data goes to the AI app you connect

  The README says AI apps such as Claude and ChatGPT send your data off your device as part of tool calls. A local model through llama.cpp keeps it on the Mac. github.com

• It can start phone calls

  phone_call dials through your iPhone. macOS asks you to confirm before the call is placed. github.com

Security advisories