How do I install Apple App?

Apple App is a local plugin. Install it using PyPI package: mac-calendar-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

Read-only Mac Calendar MCP server with indexed archive search.

About

Read-only Mac Calendar MCP server with indexed archive search.

Security Report

4.7

Use Caution4.7High Risk

This is a workspace containing two MCP servers for reading Apple Mail and Calendar data. The codebase demonstrates solid security practices for filesystem operations and input validation, with proper error handling for malformed email files. However, there are several moderate concerns: broad dependency declarations without version pinning in one package, overly broad exception handling that could mask errors, and sensitive permissions (full mailbox/calendar access) that users should be aware of. The code itself is well-tested and defensive, but dependency management and error visibility could be improved. Supply chain analysis found 1 known vulnerability in dependencies. Package verification found 1 issue (1 critical, 0 high severity).

4 files analyzed · 7 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.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

env_vars

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

HTTP Network Access

Connects to external APIs or services over the internet.

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-calendar-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 (7)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