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 说明。

Related MCP server: Microsoft MCP

快速开始

olk auth login
olk auth status
olk mail list --json --results-only --select id,subject,from
olk mail search 'from:person@example.com subject:urgent'
olk calendar view --days 7
olk contacts search "Alex"
olk todo lists list
olk drive ls

对于工作/学校账户以及仅限企业版的功能：

olk auth login --enterprise

常用命令

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

输出与脚本编写

结果写入 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 进行包装，以便代理安全地消费。

• 刷新令牌存储在操作系统钥匙串中；访问令牌仅保存在内存中。

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

文档

• 命令参考

• 身份验证与账户

• 脚本编写与同步

• MCP 与 AI 代理

• 安全与隐私

• 企业应用设置

• 开发与发布

• 代理说明

贡献

make build
make test
make lint

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

许可证

请参阅 LICENSE。