How do I install Apple App?

Apple App is a local plugin. Install it using PyPI package: mac-mail-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What AI apps work with Apple App?

Apple App uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Apple App MCP Server

by Wagamama

Developer ToolsUse Caution4.7MCP RegistryLocal

Free

Server data from the Official MCP Registry

Mac Mail MCP server with full-coverage FTS5 body search for local Apple Mail.

About

Mac Mail MCP server with full-coverage FTS5 body search for local Apple Mail.

Security Report

4.7

Use Caution4.7High Risk

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.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

env_vars

Check that this permission is expected for this type of plugin.

Unverified package source

We couldn't verify that the installable package matches the reviewed source code. Proceed with caution.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-wagamama-mac-mail-mcp": {
      "args": [
        "apple-app-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

Apple App MCP

Workspace for MCP servers that expose local Apple app data to assistants.

Packages

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.

Quick Start

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

Codex CLI

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

Claude Code

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.

Development

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

Documentation

Shared agent instructions: AGENTS.md
Mail domain notes: MAIL.md
Calendar domain notes: CALENDAR.md
MCP client setup guide: docs/mcp-client-setup.md
Calendar implementation plan: docs/superpowers/plans/2026-05-30-mac-calendar-mcp-implementation.md

Docs 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.

License

GPL-3.0-or-later

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

Apple App MCP Server

About

Security Report

Findings (6)Action required

Permissions Required

How to Install

Documentation

Apple App MCP

Packages

Quick Start

Codex CLI

Claude Code

Development

Documentation

License

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Toleno

mcp-creator-python

MarkItDown

mcp-creator-typescript

FinAgent