outlook

olk — 在终端中使用 Microsoft Outlook

olk 是一个可编写脚本的 CLI 和 MCP 服务，可通过 Microsoft Graph 管理 Outlook 邮件、日历、联系人、任务和 OneDrive。它适用于个人 Outlook.com 账户和企业 Microsoft 365 账户。

安装

brew install rlrghb/tap/olk
# or
go install github.com/rlrghb/olkcli/cmd/olk@latest

npm 包名为 olkcli；安装后的命令为 olk：

npm install -g olkcli

如果 macOS 在升级后要求访问 Keychain，请参阅 macOS 说明。

快速开始

olk auth login
olk auth status
olk mail list --json --results-only --select id,subject,from
olk mail search 'from:[email protected] subject:urgent'
olk calendar view --days 7
olk contacts search "Alex"
olk todo lists list
olk drive ls

对于工作或学校账户以及仅限企业使用的功能：

olk auth login --enterprise

常用命令

需求	命令
检查已登录账户	olk auth status 或 olk whoami
查找邮件 ID 和主题	olk mail list --json --results-only --select id,subject,from
搜索邮件	olk mail search "from:[email protected] subject:urgent"
查看接下来一周	olk calendar view --days 7
搜索联系人	olk contacts search "Alex"
列出任务列表	olk todo lists list
浏览 OneDrive	olk drive ls
发送邮件	olk mail send --to [email protected] --subject "Hi" --body "Hello"
撰写包含额外抄送对象的全部回复草稿	olk mail reply <ID> --reply-all --draft --body "$(cat reply.txt)" --cc [email protected]
撰写带内嵌图片的 HTML 草稿	olk mail drafts create --to [email protected] --subject "Steps" --html --body '<img src="cid:steps">' --inline steps=steps.png
同步更改	olk changes --json
在脚本中使用 JSON	olk mail list --json --results-only
用作 MCP 服务	olk mcp

所有命令和标志请参阅命令参考。

HTML 草稿中的内嵌图片

在 HTML 中使用 cid: URL，并通过可重复使用的 --inline CID=PATH 标志提供对应图片。这适用于新草稿，以及真正的线程回复或全部回复草稿：

olk mail reply <ID> --draft --html \
  --body '<p>See both images:</p><img src="cid:logo"><img src="cid:steps">' \
  --inline logo=logo.png --inline steps=steps.png

olk mail drafts create --to [email protected] --subject "Instructions" --html \
  --body '<p>Follow these steps:</p><img src="cid:steps">' \
  --inline steps=steps.png

每个 CID 都必须唯一，并且在 HTML 中有所引用。文件必须是图片，且每个文件都不得超过 3 MB，这是 Microsoft Graph 简单附件的大小限制。草稿命令不会发送邮件；立即发送和转发不接受 --inline。

输出与脚本编写

结果写入 stdout；诊断信息和提示写入 stderr。

olk mail list --json --results-only | jq '.[].subject'
olk contacts list --plain

输出格式包括 JSON（--json）、TSV（--plain），以及默认的对齐表格。使用 --concise 可省略较大的正文或预览内容；在支持的情况下，使用 --select 可限制字段。请参阅脚本编写与同步。

安全默认设置

• 对无人值守的只读运行，请使用 --no-write --no-send --no-input。
• MCP 提供经过筛选的工具；如需进行更改，必须明确选择启用。
• 外部邮件、日历、联系人和文件文本可使用 --wrap-untrusted 包装，以便安全地供 Agent 使用。
• 刷新令牌存储在 OS 钥匙串中；访问令牌仅保留在内存中。

在连接 Agent 或分享日志之前，请阅读安全与隐私指南。

文档

• 命令参考
• 身份验证与账户
• 脚本编写与同步
• MCP 与 AI Agent
• 安全与隐私
• 企业应用设置
• 开发与发布
• Agent 说明

贡献

make build
make test
make lint

有关仓库结构、验证、CI 和发布详情，请参阅开发与发布。

许可证

请参阅 LICENSE。