teams-cli

A command-line tool for Microsoft Teams — read your chats and messages from the terminal.

Quick Start

# Install dependencies
bun install

# Login to Microsoft Teams
bun run src/main.ts login

# List your recent chats
bun run src/main.ts chats

# Read messages from a chat (by index number)
bun run src/main.ts messages 1

# Show your profile
bun run src/main.ts me

# Logout
bun run src/main.ts logout

Build Standalone Binary

# Build for current platform
bun build src/main.ts --compile --outfile teams

# Run the binary directly
./teams login
./teams chats
./teams messages 1

Cross-Compile

bun build src/main.ts --compile --target=bun-darwin-arm64 --outfile teams-macos-arm64
bun build src/main.ts --compile --target=bun-windows-x64 --outfile teams-windows.exe
bun build src/main.ts --compile --target=bun-linux-x64 --outfile teams-linux

Commands

Command	Description
teams login	Authenticate with Microsoft Teams
teams logout	Clear stored credentials
teams me	Show your profile
teams chats	List recent chats
teams messages <chat>	Read messages from a chat

Options

• --limit N — Number of items to show (default 20, max 50)
• --json — Output raw JSON from Microsoft Graph API

Requirements

• Bun (for development)
• No runtime needed for compiled binary