mcpField
M
microsoft-excel

microsoft-excel

github.com/acedatacloud文档处理17177 次安装今天更新
代码仓库

关于 microsoft-excel

microsoft-excel 用于处理存储在 OneDrive 或 SharePoint 中的在线 Excel 工作簿。它通过 curl 和 jq 调用 Microsoft Graph 工作簿 API，可查看工作表与单元格区域并编辑云端工作簿。

主要功能

  1. 01按名称查找云端工作簿
  2. 02列出工作簿工作表
  3. 03读取已用区域和指定区域
  4. 04写入区域数据
  5. 05向表格追加行

适用场景

  1. 01查看存储在 OneDrive 的工作簿
  2. 02更新单元格区域中的值
  3. 03向工作簿表格添加记录

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/acedatacloud/skills --skill microsoft-excel

安装后在 Claude Code 中输入/microsoft-excel确认已加载。

详细介绍

通过 Microsoft Graph 工作簿 API，使用 curl + jq 操作实时 Excel 工作簿。用户的 OAuth bearer token 位于 $MICROSOFT_EXCEL_TOKEN；每次调用都需要 Authorization: Bearer $MICROSOFT_EXCEL_TOKEN。基础 URL： https://graph.microsoft.com/v1.0。工作簿 API 操作的是一个驱动器项目（OneDrive/SharePoint 中的 .xlsx 文件），因此需要它的 ITEM_ID。

失败时会返回 {"error":{"code","message"}}——原样显示 message。401 = token 已过期（重新安装）。写入时出现 403 = 用户授予的是只读权限。

G="https://graph.microsoft.com/v1.0"; AUTH="Authorization: Bearer $MICROSOFT_EXCEL_TOKEN"
# Find the workbook by name (then take .id as ITEM_ID)
curl -sS -H "$AUTH" "$G/me/drive/root/search(q='budget.xlsx')" \
  | jq '.value[] | {id, name, webUrl}'
# Worksheets in the workbook
curl -sS -H "$AUTH" "$G/me/drive/items/ITEM_ID/workbook/worksheets" \
  | jq '.value[] | {id, name, position}'

读取和写入范围

ITEM="ITEM_ID"; WS="Sheet1"
# Used range (values + formulas + formats)
curl -sS -H "$AUTH" \
  "$G/me/drive/items/$ITEM/workbook/worksheets/$WS/usedRange" \
  | jq '{address, values: .values}'

# Read a specific range
curl -sS -H "$AUTH" \
  "$G/me/drive/items/$ITEM/workbook/worksheets/$WS/range(address='A1:C5')" | jq '.values'

# Update a range (confirm first). values is a 2-D array matching the address shape.
curl -sS -X PATCH -H "$AUTH" -H "Content-Type: application/json" \
  -d '{"values":[["Q3",1200],["Q4",1580]]}' \
  "$G/me/drive/items/$ITEM/workbook/worksheets/$WS/range(address='A2:B3')" | jq '.address'

向表格追加一行

curl -sS -X POST -H "$AUTH" -H "Content-Type: application/json" \
  -d '{"values":[["2026-06-21","Acme",4200]]}' \
  "$G/me/drive/items/$ITEM/workbook/tables/Table1/rows/add" | jq '.index'

注意事项

  • 此工具适用于云端工作簿（OneDrive/SharePoint）。用户上传到聊天中的本地 .xlsx 文件需要直接解析，属于另一项任务，不适用于此技能。
  • 范围 address 是类似 Sheet1!A1:C5 的字符串；指定工作表后，也可以只写 A1:C5；values 必须是与其维度匹配的二维数组。
  • 对于长时间运行的编辑，Graph 支持使用工作簿会话标头（workbook-session-id）；对于少数单元格，默认的无会话模式即可。

评论

支持 Markdown