Imessage Query Fastmcp MCP Server
I

Imessage Query Fastmcp MCP Server

An iMessage query server based on the FastMCP framework that provides functions for securely accessing and analyzing the iMessage database.
2.5 points
8.3K

What is the iMessage Query MCP Server?

The iMessage Query MCP Server is a tool built on the FastMCP framework that allows you to securely access the iMessage database on macOS. You can easily query and analyze your iMessage conversations, including message text, timestamps, attachment information, and verify the validity of phone numbers.

How to use the iMessage Query MCP Server?

After installation, you can query your iMessage database with simple commands. For example, you can retrieve chat records of a specific contact or view messages within a certain date range.

Use Cases

This tool is ideal for those who need to quickly review past conversation content, such as finding important information, organizing communication records, or analyzing historical communication trends.

Main Features

Get Chat Records
Retrieve complete chat records based on the specified phone number, supporting date filtering.
Attachment Handling
Automatically detect and process attachment information in messages to ensure data integrity and security.
Phone Number Verification
Use the phonenumbers library to strictly verify the input phone number to ensure accuracy.
Date Range Filtering
Allow users to set start and end dates and only return messages within that time period.
Advantages
Read-only access to the iMessage database to ensure data security.
Built-in phone number verification function to reduce the risk of incorrect input.
Support attachment handling of multiple file types to improve compatibility.
Provide a concise and intuitive JSON format output for easy subsequent parsing and use.
Limitations
Only support the macOS system.
Require Python 3.6 or higher to be installed.
Queries may take some time for very large databases.

How to Use

Clone the Repository
Run the following command in the terminal to clone the project code: ```bash git clone https://github.com/hannesrudolph/imessage-query-fastmcp-mcp-server.git ```
Install Dependencies
After entering the project directory, run the following command to install the required dependencies: ```bash pip install -r requirements.txt ```
Start the Server
After installation is complete, use the following command to start the MCP server: ```bash python3 imessage-query-server.py ```
Test the Query
Run the following command to test if it works properly: ```bash get_chat_transcript +1234567890 ```

Usage Examples

Example 1: Query Chat Records of the Last Week
Suppose you want to view the conversation content with a friend in the past week.
Example 2: Export Attachments of a Specific Date
If you need to collect all files sent on a certain day, you can perform the following operations.

Frequently Asked Questions

Does the iMessage Query MCP Server support Windows?
How to update the MCP server?
Can I export the chat records of multiple contacts in batches?

Related Resources

Official Documentation
Read the complete project documentation and support pages.
FastMCP Official Website
Learn the basics of the FastMCP framework.
GitHub Code Repository
Download the source code and participate in development.

Installation

Copy the following command to your Client for configuration
Note: Your key is sensitive information, do not share it with anyone.

Alternatives

M
MCP
The Microsoft official MCP server provides search and access functions for the latest Microsoft technical documentation for AI assistants
8.7K
5 points
A
Aderyn
Aderyn is an open - source Solidity smart contract static analysis tool written in Rust, which helps developers and security researchers discover vulnerabilities in Solidity code. It supports Foundry and Hardhat projects, can generate reports in multiple formats, and provides a VSCode extension.
Rust
5.9K
5 points
D
Devtools Debugger MCP
The Node.js Debugger MCP server provides complete debugging capabilities based on the Chrome DevTools protocol, including breakpoint setting, stepping execution, variable inspection, and expression evaluation.
TypeScript
5.4K
4 points
S
Scrapling
Scrapling is an adaptive web scraping library that can automatically learn website changes and re - locate elements. It supports multiple scraping methods and AI integration, providing high - performance parsing and a developer - friendly experience.
Python
7.8K
5 points
M
Mcpjungle
MCPJungle is a self-hosted MCP gateway used to centrally manage and proxy multiple MCP servers, providing a unified tool access interface for AI agents.
Go
0
4.5 points
C
Cipher
Cipher is an open-source memory layer framework designed for programming AI agents. It integrates with various IDEs and AI coding assistants through the MCP protocol, providing core functions such as automatic memory generation, team memory sharing, and dual-system memory management.
TypeScript
0
5 points
N
Nexus
Nexus is an AI tool aggregation gateway that supports connecting multiple MCP servers and LLM providers, providing tool search, execution, and model routing functions through a unified endpoint, and supporting security authentication and rate limiting.
Rust
0
4 points
S
Shadcn Ui MCP Server
An MCP server that provides shadcn/ui component integration for AI workflows, supporting React, Svelte, and Vue frameworks. It includes functions for accessing component source code, examples, and metadata.
TypeScript
12.1K
5 points
G
Gitlab MCP Server
Certified
The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.
TypeScript
16.6K
4.3 points
N
Notion Api MCP
Certified
A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.
Python
14.8K
4.5 points
M
Markdownify MCP
Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.
TypeScript
24.5K
5 points
D
Duckduckgo MCP Server
Certified
The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.
Python
44.7K
4.3 points
U
Unity
Certified
UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.
C#
20.2K
5 points
F
Figma Context MCP
Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.
TypeScript
44.3K
4.5 points
M
Minimax MCP Server
The MiniMax Model Context Protocol (MCP) is an official server that supports interaction with powerful text-to-speech, video/image generation APIs, and is suitable for various client tools such as Claude Desktop and Cursor.
Python
30.2K
4.8 points
C
Context7
Context7 MCP is a service that provides real-time, version-specific documentation and code examples for AI programming assistants. It is directly integrated into prompts through the Model Context Protocol to solve the problem of LLMs using outdated information.
TypeScript
62.4K
4.7 points
AIBase
Zhiqi Future, Your AI Solution Think Tank
© 2025AIBase