iMessage MCP server

This is a small helper that lets your AI read your iMessage history on a Mac. You can ask it things like what you talked about with someone last week, or when a certain word came up in your texts. It is handy if you use ChatGPT or Claude and want answers about your own messages without scrolling through the app yourself.

What this MCP server does

You ask your AI a question about your messages, like who you texted about dinner. Your AI passes that request to this helper program running on your Mac. The helper opens your iMessage database in read-only mode and looks for matching messages, chats, or contacts. It hands the results back to your AI, which turns them into a normal answer in the chat. Everything stays on your computer, and nothing is sent or edited.

Click to zoom

What you can do with it

• Search your messages by a word or phrase
• Filter messages by a phone number or email address
• Narrow a search to a date range
• List your recent messages
• List all your conversations
• List all the phone numbers and emails you have messaged
• Look up a contact in your Mac Contacts and get their number

Try asking your AI

• “What did I text my sister about last month?”
• “Show me my 20 most recent messages.”
• “Find any messages where I mentioned the word invoice.”
• “What is John Smith's phone number in my contacts?”

What it gives back to you

You get back a list of matching messages, chats, or contacts, shown as text in your chat. Each message usually includes who it was from or to, the date, and the message text. Searches also tell you how many results there are in total and whether there are more pages. Your AI then reads that list and answers your question in plain words.

Before you start

Who it's for

Mac users who use ChatGPT or Claude and want to ask questions about their own text message history.