iwork MCP

iwork mcp

用于Apple iWork自动化的MCP服务器——113个用于数字、页面和主题演讲的工具。

一条线要安装。适用于Claude Desktop、Claude Code、Codex和任何MCP客户端。

它的作用

让Claude构建电子表格、编写文档和创建演示文稿——它通过苹果的JavaScript for Automation（JXA）脚本桥控制Mac上真正的iWork应用程序。

数字 --浏览内置模板（预算、发票、时间表等）或从头开始创建，读/写单元格和范围，设置公式（包括SUMIFS等跨表引用），排序行，合并单元格，格式化单元格（字体、颜色、背景、对齐方式、百分比和货币等数字格式），管理表格和表格，设置列宽和行高，一次性批量创建包含数据和格式的表格，导出到PDF/Excel/CSV。

页面 --浏览内置模板（简历、报告、信件、传单、时事通讯等）或从头开始创建，在一次通话中创建具有格式化内容的文档，在任何位置读取和插入文本，查找和替换（保留格式），格式化段落（字体、大小、颜色），插入图像和表格，导出到PDF/Word/EPUB。

主题演讲 --浏览可用主题或使用特定主题创建，在一次调用中使用多个完全配置的幻灯片（布局、标题、正文、注释、过渡）创建演示文稿，添加/删除/复制/重新排序/跳过幻灯片，从主幻灯片中选择幻灯片布局，阅读幻灯片内容，设置标题和要点，添加图像和形状，开始/停止幻灯片，导出到PDF/PowerPoint/HTML。

More examples

安装

克劳德桌面

npx iwork-mcp install

然后重新启动克劳德桌面（Cmd+Q并重新打开）。完成。

克劳德代码

claude mcp add iwork -- npx -y iwork-mcp

法典

codex mcp add iwork -- npx -y iwork-mcp

需求

• macOS 13 Ventura或更高版本 （在macOS 14 Sonoma上测试）
• 数字、页面和主题演讲14.0+ （在14.5和15.1.1 Creator Studio上测试；从App Store免费）
• (brew install node 如果你有自制啤酒）
• 首次使用时，macOS将要求授予自动化权限——单击“确定”

iWork 15.1+（创作者工作室）：完全支持----在15.1.1（2026年2月）进行了测试。Creator Studio会自动检测并在可用时使用。Creator Studio订阅者将获得8个额外的AI工具（魔术填充、清理幻灯片、超分辨率、删除背景）。看 Creator Studio已知问题 以下为导出/保存为限制。

例子

用数字构建一个月度预算电子表格，包括收入、支出和净储蓄行。颜色正差绿色和负红色。

在Pages中为在三家公司、教育和技能部门有经验的软件工程师创建一份专业简历。

用6张幻灯片为第四季度业务回顾做主题演讲——亮点、收入、产品里程碑和路线图。在每张幻灯片上添加演示者笔记。

在~/Documents/budget.numbers打开我的预算电子表格，并为2月份添加新行。

用数字创建2026年的日历，每个月都有一张表，彩色标题和周末突出显示。

工具

数字（50个工具）

页面（22个工具）

主题演讲（41个工具）

运作原理

服务器通过以下方式运行JXA（JavaScript for Automation）脚本 osascript 控制iWork应用程序。每个工具调用都是一个 osascript 调用——参数以JSON格式通过 argv[0]，结果通过stdout以JSON形式返回。

Claude Desktop / Claude Code / Codex
  ↓ MCP protocol over stdio
iwork-mcp server (Node.js)
  ↓ child_process.execFile
/usr/bin/osascript -l JavaScript
  ↓ JXA scripting bridge
Numbers.app / Pages.app / Keynote.app

发展

git clone https://github.com/reichenbach/iwork_mcp.git
cd iwork-mcp
npm install
npm run build

测试

npm test              # Unit tests — tool registration + error parsing (~300ms, no apps needed)
npm run test:integration  # Integration tests — Numbers/Pages/Keynote CRUD (~6s, requires iWork apps)
npm run test:all      # Both tiers combined

测试使用 node:test 具有内存中的MCP传输（无子进程）。如果未安装相应的应用程序，集成测试会自动跳过。

使用Claude Desktop进行本地开发

要使用Claude Desktop进行本地测试，请指向您的本地版本：

{
  "mcpServers": {
    "iwork": {
      "command": "node",
      "args": ["/absolute/path/to/iwork-mcp/dist/index.js"]
    }
  }
}

局限性

iWork的脚本字典定义了什么是可自动化的——一些功能（图表、轨迹变化、评论）根本不被苹果公司公开。iwork-mcp涵盖了API允许的所有内容。我希望随着人工智能工具在整个生态系统中变得更加集成，苹果能够扩展自动化能力。

• 仅限macOS --需要数字、页面和Keynote 14.0+（在14.5和15.1 Creator Studio上测试；从App Store免费）
• 应用程序可见 --iWork应用程序启动并显示窗口；没有无头模式
• 每次通话约430毫秒 --每次工具调用的osascript启动开销（使用复合工具，如 create_sheet_with_table, create_document_with_content，以及 create_presentation_with_slides 速度）
• 图表是基本的 — numbers_add_chart 通过AppleScript桥解决方法创建数据绑定图表（条形图、线条图、饼图、面积图、散点图），但图表自定义（标题、标签、颜色）不由Apple的脚本字典公开
• 公式只能写入 --苹果的脚本字典返回计算值，而不是公式文本
• 无评论或跟踪更改 --未在脚本字典中公开
• 页面格式 --段落格式使用 bodyText.paragraphs 支持字体、大小和颜色；粗体/斜体需要PostScript字体名称（例如。 HelveticaNeue-Bold)；没有直接的粗体/斜体切换
• 首次使用权限提示 --macOS将请求授予自动化访问权限一次

Creator Studio已知问题

iWork 15.1–15.1.1 Creator Studio有脚本错误，iWork-mcp会自动解决：

• app.export() 失败 对于所有非PDF格式，出现错误（6）——“无法导出文档”。PDF导出通过Quick Look解决方法工作(qlmanage).Creator Studio上的非PDF导出格式（Excel、CSV、Word、EPUB、PowerPoint、HTML、图像）已损坏，没有已知的解决方法。
• doc.save() 悬挂 并显示一个永远不会返回的弹出对话框（有和没有路径参数）。另存为通过文件复制解决方法工作（复制自动保存的iCloud文件，然后关闭并从新路径重新打开）。iCloud自动保存会自动处理纯保存（无路径）。
• 自动保存重命名文档 通过附加文件扩展名（例如，“Untitled”变为“Untitled.numbers”），这会中断 documents.byName() 查找。iwork mcp注入了名称解析，该解析会尝试原始名称和扩展名称，并在自动保存过程中出现短暂故障时自动重试。

检测到Creator Studio时，所有解决方法都会自动应用。如果您需要非PDF导出，请使用Mac App Store中的经典iWork 14.x版本。

许可证

麻省理工学院