Skip to main content
Glama
shaack

mcps-for-macos

by shaack

mcps-for-macos

一个用于 macOS 自动化的 MCP 服务器(Model Context Protocol)集合。每个服务器通过 AppleScript 或命令行封装一个应用或系统功能,并将其作为工具提供给 AI 应用(Claude Desktop、Claude Code)调用。

服务器

用途

Apple 日历

packages/apple-calendar

读取和创建日程(Calendar.app)

Apple 邮件

packages/apple-mail

搜索和阅读邮件、保存附件、标记、移动、撰写回复草稿

MoneyMoney

packages/money-money

导出账户和交易记录

Spotlight

packages/spotlight

系统级文件搜索(mdfind/mdls)

公共辅助工具(AppleScript 执行及转义、命令执行)位于 packages/common 中,服务器通过 @mcps/common 使用它们。

什么是 MCP 服务器?

MCP 是一个开放标准,AI 应用(主机)通过它与外部工具和数据通信。服务器提供能力(工具),本身并不了解 AI。通信基于 JSON-RPC 2.0,此处通过 stdio(本地进程)进行。注册意味着:告诉主机如何启动服务器。主机在每次会话启动时将其作为子进程启动,查询其工具并将其提供给 AI。

Related MCP server: macos-mcp-tools

安装

npm install

在根目录执行一次 npm install 即可满足所有服务器(npm workspaces)的需求。无需构建步骤:纯 ESM JavaScript,Node >= 18。

注册

每个服务器都需要单独注册,因为每个都是独立的进程。路径必须使用绝对路径;<REPO> 表示此仓库的路径。

Claude Code

# global in allen Projekten (empfohlen für Systemwerkzeuge)
claude mcp add apple-calendar --scope user -- node <REPO>/packages/apple-calendar/src/index.js
claude mcp add apple-mail  --scope user -- node <REPO>/packages/apple-mail/src/index.js
claude mcp add money-money --scope user -- node <REPO>/packages/money-money/src/index.js
claude mcp add spotlight   --scope user -- node <REPO>/packages/spotlight/src/index.js

如果不使用 --scope user,注册仅适用于当前项目。检查和移除:

claude mcp list
claude mcp remove spotlight

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json 中:

{
  "mcpServers": {
    "apple-calendar": { "command": "node", "args": ["<REPO>/packages/apple-calendar/src/index.js"] },
    "apple-mail":  { "command": "node", "args": ["<REPO>/packages/apple-mail/src/index.js"] },
    "money-money": { "command": "node", "args": ["<REPO>/packages/money-money/src/index.js"] },
    "spotlight":   { "command": "node", "args": ["<REPO>/packages/spotlight/src/index.js"] }
  }
}

macOS 权限

  • 自动化。 首次访问时,macOS 会请求对 Mail、日历或 MoneyMoney 的自动化访问权限。允许一次即可。

  • 完全磁盘访问。 受保护的位置(例如 ~/Library/Mail)只有为执行进程授予完全磁盘访问权限后才能返回结果(系统设置 → 隐私与安全性 → 完全磁盘访问权限)。

本地测试

使用 MCP Inspector 逐个点击测试每个服务器:

npm run inspect -w @mcps/spotlight

许可证

MIT

A
license - permissive license
Not graded
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    Not graded
    quality
    B
    maintenance
    A read-only MCP server that exposes data from native macOS apps (Mail, Notes, Calendar, Reminders, Contacts, Messages, Spotlight) to AI agents over stdio, currently in early development with no domain tools wired yet.
    11
    4
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    A collection of MCP servers for Apple macOS apps (Mail, Contacts, Notes, Memory, Messages, Calendar, Reminders) enabling AI assistants to read, search, create, and update data via JXA, SQLite, and EventKit.
    12
    MIT
  • A
    license
    B
    quality
    B
    maintenance
    An MCP server that gives AI assistants full access to Apple Mail -- read, search, compose, organize, and analyze emails via natural language.
    38
    MIT

View all related MCP servers

Related MCP Connectors

  • Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.

  • Let ChatGPT, Claude & Cursor use your Mac: email, calendar, iMessage, Teams, files. Local, free.

  • Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/shaack/mcps-for-macos'

If you have feedback or need assistance with the MCP directory API, please join our Discord server