outlook

olk — ターミナルで Microsoft Outlook を操作

olk は、Microsoft Graph を通じて Outlook のメール、カレンダー、連絡先、タスク、OneDrive を操作できるスクリプト対応の CLI および MCP サーバーです。個人用の 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 or 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"
Cc を追加して全員に返信する下書きを作成する	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 内で参照されている必要があります。ファイルは画像で、Microsoft Graph のシンプルな添付ファイルの上限である 3 MB 未満である必要があります。下書きコマンドはメールを送信しません。即時送信および転送では --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 でラップできます。
• 更新トークンは OS のキーチェーンに保存され、アクセストークンはメモリ内にのみ保持されます。

エージェントを接続したりログを共有したりする前に、セキュリティとプライバシーのガイドをお読みください。

ドキュメント

• コマンドリファレンス
• 認証とアカウント
• スクリプトと同期
• MCP と AI エージェント
• セキュリティとプライバシー
• エンタープライズアプリのセットアップ
• 開発とリリース
• エージェント向けの手順

コントリビューション

make build
make test
make lint

リポジトリの構成、検証、CI、公開の詳細については、開発とリリースをご覧ください。

ライセンス

LICENSEをご覧ください。