Server data from the Official MCP Registry
Mac Mail MCP server with full-coverage FTS5 body search for local Apple Mail.
Mac Mail MCP server with full-coverage FTS5 body search for local Apple Mail.
This is a well-structured MCP server workspace for reading Apple Mail and Calendar data locally. The codebase demonstrates good security practices with proper input validation, safe path handling (including path traversal protection), and comprehensive error handling. Permissions are appropriate for the stated purpose of reading local Apple app data. Minor code quality observations do not significantly impact security. Supply chain analysis found 1 known vulnerability in dependencies. Package verification found 1 issue (1 critical, 0 high severity).
4 files analyzed · 6 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Unverified package source
We couldn't verify that the installable package matches the reviewed source code. Proceed with caution.
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-wagamama-mac-mail-mcp": {
"args": [
"apple-app-mcp"
],
"command": "uvx"
}
}
}From the project's GitHub README.
Workspace for MCP servers that expose local Apple app data to assistants.
| Package | Status | Purpose |
|---|---|---|
mac-mail-mcp | Beta | Mac Mail MCP server with disk-first reads and full-coverage FTS5 body search. |
mac-calendar-mcp | Alpha | Read-only Mac Calendar MCP server with indexed archive search. |
Install the package you want:
pipx install mac-mail-mcp
pipx install mac-calendar-mcp
Build local indexes for fast search:
mac-mail-mcp index --verbose
mac-calendar-mcp index
Register one or both servers:
codex mcp add mail -- mac-mail-mcp
codex mcp add calendar -- mac-calendar-mcp
Confirm the registrations:
codex mcp list
codex mcp get mail
codex mcp get calendar
Create or edit .mcp.json in your project root:
{
"mcpServers": {
"mail": {
"command": "mac-mail-mcp"
},
"calendar": {
"command": "mac-calendar-mcp"
}
}
}
For global Claude Code configuration, put the same mcpServers object in
~/.claude/mcp.json.
This repository is organized as a uv workspace. Each MCP server lives under
packages/ with its own package metadata, source, tests, and README.
git clone https://github.com/wagamama/apple-app-mcp
cd apple-app-mcp
uv sync
# All packages
uv run ruff check packages/mac-mail-mcp/src packages/mac-calendar-mcp/src
uv run pytest
# Individual packages
uv run --package mac-mail-mcp pytest packages/mac-mail-mcp/tests
uv run --package mac-calendar-mcp pytest packages/mac-calendar-mcp/tests
Build distributions:
uv build --package mac-mail-mcp
uv build --package mac-calendar-mcp
AGENTS.mdMAIL.mdCALENDAR.mddocs/mcp-client-setup.mddocs/superpowers/plans/2026-05-30-mac-calendar-mcp-implementation.mdDocs are deployed with GitHub Pages from .github/workflows/docs.yml. The
repository must have Pages configured once in Settings -> Pages -> Build and
deployment -> Source: GitHub Actions. The workflow deploys the built artifact;
it does not try to create or enable the Pages site because GitHub rejects that
operation from the default workflow token in some repositories.
GPL-3.0-or-later
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.