l22-io/orchard-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

21 stars 2 forks Качество 75 Тренд 14MIT

Repository Install

MCP-сервер для Apple Calendar, Mail и Reminders на macOS с использованием нативных EventKit и ScriptingBridge

Обзор

MCP-сервер для локальных приложений и файлов macOS с использованием собственных фреймворков. Предоставляет любому MCP-совместимому клиенту (Warp, Claude Desktop, Claude Code, Cursor) структурированный доступ к Apple Calendar, Mail, Reminders, Notes, Contacts, Files, Numbers, Pages и Keynote. Не существует облачных зависимостей и настройки OAuth: данные поступают из локальных магазинов macOS и приложений, уже настроенных на вашем компьютере. Orchard-mcp читает из локальных хранилищ данных macOS и приложений: EventKit для календаря и напоминаний - Contacts.framework для контактов - FileManager, Spotlight, PDFKit и Vision для извлечения файлов и текста - AppleScript / JXA для почты, заметок, номеров, страниц и Keynote Операционная система обрабатывает аутентификацию учетной записи через . orchard-mcp сама по себе никогда не общается с какой-либо удаленной службой и не требует идентификаторов клиентов OAuth, перенаправления URI или управления токенами. Orchard-mcp не отправляет никаких данных.

Обзор (машинный перевод)

MCP-сервер для локальных приложений и файлов macOS с использованием собственных фреймворков.

Предоставляет любой MCP-совместимый клиент (Warp, Claude Desktop, Claude Code, Cursor) доступ к календарю Apple, почте, напоминаниям, заметкам, контактам, файлам, номерам, страницам и Ключевая нота. Нет облачных зависимостей и нет настройки OAuth: данные поступают из локальных источников. Магазины и приложения macOS уже настроены на вашем компьютере.

Как это работает

Orchard-mcp читает из локальных хранилищ данных macOS и приложений:

EventKit для календарей и напоминаний Контакты.framework для контактов FileManager, Spotlight, PDFKit и Vision для извлечения файлов и текста AppleScript / JXA для почты, заметок, номеров, страниц и примечаний

Операционная система обрабатывает аутентификацию учетной записи через **Настройки системы > Интернет-аккаунты **. Orchard-mcp никогда не общается с какой-либо удаленной службой и не требует OAuth. идентификаторы клиентов, перенаправление URI или управление токенами.

**Примечание о конфиденциальности: ** Orchard-mcp сам по себе не отправляет никаких данных. Однако клиент MCP которые задействуют инструменты, получают возвращенные данные (календарь событий, электронные письма, напоминания). файлы, заметки, контакты и документы) как часть контекста разговора. Будьте внимательны То, к чему вы просите клиента.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

orchard-mcp

MCP server for local macOS apps and files using native frameworks.

Gives any MCP-compatible client (Warp, Claude Desktop, Claude Code, Cursor) structured access to Apple Calendar, Mail, Reminders, Notes, Contacts, Files, Numbers, Pages, and Keynote. There are no cloud dependencies and no OAuth setup: data comes from the local macOS stores and apps already configured on your machine.

How it works

orchard-mcp reads from local macOS data stores and apps:

EventKit for Calendar and Reminders
Contacts.framework for Contacts
FileManager, Spotlight, PDFKit, and Vision for files and text extraction
AppleScript/JXA for Mail, Notes, Numbers, Pages, and Keynote

The OS handles account authentication through System Settings > Internet Accounts. orchard-mcp itself never communicates with any remote service and requires no OAuth client IDs, redirect URIs, or token management.

Privacy note: orchard-mcp itself sends no data anywhere. However, the MCP client that invokes tools receives the returned data (calendar events, emails, reminders, files, notes, contacts, and documents) as part of the conversation context. Be mindful of what you ask the client to access.

App Safety

orchard-mcp refuses broad requests rather than making host apps unresponsive. Mail.app, Notes, Numbers, Pages, and Keynote calls are serialized through app-specific safety lanes with timeout, queue, and output-size budgets. Expensive scopes are rejected before AppleScript/JXA starts.

Examples:

mail_save_attachment requires account and mailbox from a recent Mail result.
Notes body/all search is refused; use title search, then notes_read_note.
numbers_read and numbers_get_formulas require a cell range.
PNG/JPEG Keynote export requires a single slide index.
Calendar list/search ranges are capped at 31 days.

See docs/app-safety-audit.md for the current audit and guardrails.

The only permissions needed are macOS TCC grants (for example, “Allow access to Calendars”), triggered automatically on first use or during setup.

Status

Current release: 65 tools across Calendar, Mail, Reminders, Files, System, Numbers, Pages, Keynote, Notes, and Contacts. See CHANGELOG.md for release history.

Requirements

macOS 14+ (Sonoma or later)
Node.js 22+

Install

npm install -g @l22-io/orchard-mcp
orchard-mcp setup

If Xcode Command Line Tools are installed (xcode-select --install), postinstall builds apple-bridge from source - the strongest install-time guarantee. Otherwise the package falls back to the shipped prebuilt universal binary (arm64 + x86_64) and verifies its SHA-256 against the manifest published inside the tarball.

The setup wizard verifies prerequisites, triggers macOS permission prompts, and generates MCP client configuration.

From Source

See CONTRIBUTING.md for building from source.

Открыть полный README на GitHub

Установка

npx @l22-io/orchard-mcp

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "orchard": {
      "command": "npx",
      "args": ["@l22-io/orchard-mcp"]
    }
  }
}