Apple Mail MCP

Apple Mail MCP server with full-coverage FTS5 body search, reliable on large mailboxes.

io.github.imdinu/apple-mail-mcp · Repository · version 0.4.3 · 56 stars · listed from registry

Install

The sweep installs into a clean prefix, but this is the command a user would run:

uvx apple-mail-mcp

Results by platform

Linux

installs and connects2026-08-16 · probed over pypi

2 recorded runs, oldest first.

tools/list returned 8 tools.

list_accounts list_mailboxes get_emails get_email get_email_links get_email_attachment get_attachment search

macOS

installs and connects2026-08-16 · probed over pypi

2 recorded runs, oldest first.

tools/list returned 8 tools.

list_accounts list_mailboxes get_emails get_email get_email_links get_email_attachment get_attachment search

Windows

MCP handshake failed2026-08-15 · probed over pypi

1 recorded run, oldest first.

handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Downloading selectolax (1.8MiB)
 Downloaded selectolax
Installed 73 packages in 16.52s
Traceback (most recent call last):
  File "<frozen runpy>", line 198, in _run_module_as_main
  File "<frozen runpy>", line 88, in _run_code
  File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\1exxBZVXjicNb9Mo\Scripts\apple-mail-mcp.exe\__main__.py", line 10, in <module>
  File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\1exxBZVXjicNb9Mo\Lib\site-packages\apple_mail_mcp\cli.py", line 919, in main
    app()
  File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\1exxBZVXjicNb9Mo\Lib\site-packages\cyclopts\core.py", line 1962, in __call__
    result = _run_maybe_async_command(command, bound, resolved_backend)
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\1exxBZVXjicNb9Mo\Lib\site-packages\cyclopts\_run.py", line 50, in _run_maybe_async_command
    return command(*bound.args, **bound.kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\1exxBZVXjicNb9Mo\Lib\site-packages\apple_mail_mcp\cli.py", line 570, in default_handler
    _run_serve(watch=watch, read_only=read_only)
  File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\1exxBZVXjicNb9Mo\Lib\site-packages\apple_mail_mcp\cli.py", line 157, in _run_serve
    from .index import IndexManager
  File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\1exxBZVXjicNb9Mo\Lib\site-packages\apple_mail_mcp\index\__init__.py", line 11, in <module>
    from .lock import IndexLock
  File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\1exxBZVXjicNb9Mo\Lib\site-packages\apple_mail_mcp\index\lock.py", line 21, in <module>
    import fcntl
ModuleNotFoundError: No module named 'fcntl'

Badge

Paste this into the project README to show the current result:

[![does it install](https://img.shields.io/endpoint?url=https://doesitinstall.com/badge/io.github.imdinu__apple-mail-mcp.json)](https://doesitinstall.com/s/io.github.imdinu__apple-mail-mcp.html)