{
  "markdown": "# olk — Microsoft Outlook in Your Terminal\n\n`olk` is a scriptable CLI and MCP server for Outlook mail, calendars, contacts,\ntasks, and OneDrive through Microsoft Graph. It works with personal Outlook.com\naccounts and enterprise Microsoft 365 accounts.\n\n## Install\n\n```bash\nbrew install rlrghb/tap/olk\n# or\ngo install github.com/rlrghb/olkcli/cmd/olk@latest\n```\n\nThe npm package is `olkcli`; the installed command is `olk`:\n\n```bash\nnpm install -g olkcli\n```\n\nSee [macOS notes](docs/authentication.md#macos-keychain) if macOS asks for\nKeychain access after an upgrade.\n\n## Quick start\n\n```bash\nolk auth login\nolk auth status\nolk mail list --json --results-only --select id,subject,from\nolk mail search 'from:person@example.com subject:urgent'\nolk calendar view --days 7\nolk contacts search \"Alex\"\nolk todo lists list\nolk drive ls\n```\n\nFor work/school accounts and enterprise-only features:\n\n```bash\nolk auth login --enterprise\n```\n\n## Common commands\n\n| Need | Command |\n| --- | --- |\n| Check the signed-in account | `olk auth status` or `olk whoami` |\n| Find message IDs and subjects | `olk mail list --json --results-only --select id,subject,from` |\n| Search mail | `olk mail search \"from:person@example.com subject:urgent\"` |\n| View the next week | `olk calendar view --days 7` |\n| Search contacts | `olk contacts search \"Alex\"` |\n| List task lists | `olk todo lists list` |\n| Browse OneDrive | `olk drive ls` |\n| Send mail | `olk mail send --to person@example.com --subject \"Hi\" --body \"Hello\"` |\n| Draft HTML with an inline image | `olk mail drafts create --to person@example.com --subject \"Steps\" --html --body '<img src=\"cid:steps\">' --inline steps=steps.png` |\n| Synchronize changes | `olk changes --json` |\n| Use JSON for scripts | `olk mail list --json --results-only` |\n| Use as an MCP server | `olk mcp` |\n\nSee the [command reference](docs/commands.md) for all commands and flags.\n\n### Inline images in HTML drafts\n\nUse a `cid:` URL in the HTML and supply the matching image with repeatable\n`--inline CID=PATH` flags. This works for new drafts and true threaded reply or\nreply-all drafts:\n\n```bash\nolk mail reply <ID> --draft --html \\\n  --body '<p>See both images:</p><img src=\"cid:logo\"><img src=\"cid:steps\">' \\\n  --inline logo=logo.png --inline steps=steps.png\n\nolk mail drafts create --to person@example.com --subject \"Instructions\" --html \\\n  --body '<p>Follow these steps:</p><img src=\"cid:steps\">' \\\n  --inline steps=steps.png\n```\n\nEach CID must be unique and referenced by the HTML. Files must be images and\neach must be under 3 MB, the Microsoft Graph simple-attachment limit. Draft\ncommands do not send mail; immediate sends and forwards do not accept\n`--inline`.\n\n## Output and scripting\n\nResults are written to stdout; diagnostics and prompts go to stderr.\n\n```bash\nolk mail list --json --results-only | jq '.[].subject'\nolk contacts list --plain\n```\n\nOutput modes are JSON (`--json`), TSV (`--plain`), and aligned tables by\ndefault. Use `--concise` to omit large bodies/previews and `--select` to limit\nfields where supported. See [scripting and sync](docs/scripting.md).\n\n## Safety defaults\n\n- Use `--no-write --no-send --no-input` for unattended read-only runs.\n- MCP exposes curated tools and requires explicit opt-in for mutations.\n- External mail, calendar, contact, and file text can be wrapped with\n  `--wrap-untrusted` for agent-safe consumption.\n- Refresh tokens are stored in the OS keychain; access tokens are kept in\n  memory only.\n\nRead the [security and privacy guide](docs/security.md) before connecting an\nagent or sharing logs.\n\n## Documentation\n\n- [Command reference](docs/commands.md)\n- [Authentication and accounts](docs/authentication.md)\n- [Scripting and synchronization](docs/scripting.md)\n- [MCP and AI agents](docs/mcp.md)\n- [Security and privacy](docs/security.md)\n- [Enterprise app setup](docs/enterprise-setup.md)\n- [Development and releases](docs/development.md)\n- [Agent instructions](SKILL.md)\n\n## Contributing\n\n```bash\nmake build\nmake test\nmake lint\n```\n\nSee [development and releases](docs/development.md) for repository structure,\nvalidation, CI, and publishing details.\n\n## License\n\nSee [LICENSE](LICENSE).\n",
  "bytes": 4165,
  "sha": "a34ccd053702516a3b5261a3aa80056b1814307d538f9714e1d2a600cf0f576d",
  "repo_slug": "rlrghb/olkcli",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_rlrghb_outlook_b96e6b3d/readme"
}