How spenserhale/outlook-ai-toolkit works
Outlook Toolkit exposes Outlook mail and account management through a CLI and an MCP server, backed by a shared SDK for Microsoft Graph. The primary flow is CLI sign-in (including profile/config resolution) followed by mail commands, which use SDK mail operations and Graph requests. The MCP server separately registers authentication, mail, and inbox-rule tools. The graph preserves documented sync, body formatting, and bulk-move capabilities; some CLI-to-SDK internals and storage wiring are not shown in the sampled excerpts, so those links are omitted or identified as documented.
Main entry points: app.ts CLI routes · session.ts Sign-in session · mail-client.ts Mail operations · auth.ts OAuth and status
Components 25
CLI
- CLI routes
packages/cli/src/app.ts - Sign-in session
packages/cli/src/commands/session.ts - Account context
packages/cli/src/context.ts - Profile commands
packages/cli/src/commands/profile.ts - Mail commands
packages/cli/src/commands/mail.ts - Agent schema
packages/cli/src/commands/agent-context.ts
SDK
- Config resolution
packages/sdk/src/config.ts - OAuth and status
packages/sdk/src/auth.ts - Token storage
packages/sdk/src/token-store.ts - Profile storage
packages/sdk/src/profile-store.ts - Mail operations
packages/sdk/src/mail-client.ts - Sweep queries
packages/sdk/src/sweep-query.ts - Inbox rules
packages/sdk/src/rules-client.ts - Graph transport
packages/sdk/src/graph-client.ts - Body conversion
packages/sdk/src/body.ts - Output formatting
packages/sdk/src/format.ts - Domain schemas
packages/sdk/src/types.ts
MCP Server
- MCP tool server
packages/mcp/src/server.ts - Auth tools
packages/mcp/src/tools/auth.ts - Mail tools
packages/mcp/src/tools/mail.ts - Rule tools
packages/mcp/src/tools/rules.ts
External Services
- Microsoft identity
- Microsoft Graph
- OS credential store
Other components
- User or agent
Connections 26
- User or agent → CLI routes: runs commands
README.md - CLI routes → Sign-in session: routes to
packages/cli/src/app.ts - CLI routes → Mail commands: routes to
packages/cli/src/app.ts - CLI routes → Profile commands: routes to
packages/cli/src/app.ts - CLI routes → Agent schema: routes to
packages/cli/src/app.ts - Sign-in session → Account context: resolves account
packages/cli/src/commands/session.ts - Sign-in session → OAuth and status: starts sign-in
packages/cli/src/commands/session.ts - Sign-in session → Token storage: creates store
packages/cli/src/commands/session.ts - Profile commands → Profile storage: manages profiles
packages/cli/src/commands/profile.ts - Profile commands → Sign-in session: starts sign-in
packages/cli/src/commands/profile.ts - Account context → Config resolution: resolves config
packages/cli/src/context.ts - Mail commands → Mail operations: uses SDK mail
README.md - MCP tool server → Auth tools: registers
packages/mcp/src/server.ts - MCP tool server → Mail tools: registers
packages/mcp/src/server.ts - MCP tool server → Rule tools: registers
packages/mcp/src/server.ts - Auth tools → OAuth and status: uses authentication
packages/mcp/src/tools/auth.ts - Mail tools → Mail operations: uses mail SDK
packages/mcp/src/tools/mail.ts - Rule tools → Inbox rules: uses rules SDK
packages/mcp/src/tools/rules.ts - OAuth and status → Config resolution: uses settings
packages/sdk/src/auth.ts - OAuth and status → Microsoft identity: authenticates with
- Token storage → OS credential store: stores tokens
README.md - Mail operations → Graph transport: requests mail data
packages/sdk/src/mail-client.ts - Mail operations → Body conversion: converts bodies
packages/sdk/src/mail-client.ts - Mail operations → Sweep queries: builds sweep queries
packages/sdk/src/mail-client.ts - Inbox rules → Graph transport: requests rule data
packages/sdk/src/rules-client.ts - Graph transport → Microsoft Graph: sends Graph requests
packages/sdk/src/graph-client.ts