basecamp/hey-cli

What it solves

This project provides a command-line interface (CLI) and terminal user interface (TUI) for HEY email and calendar services. It allows users to manage their communications and scheduling without leaving the terminal, and more importantly, it enables AI coding agents to interact with the user's email and calendar data via a standardized interface.

How it works

The tool is written in Go and integrates directly with HEY's services. It offers two primary modes of operation:

1. TUI Mode: A visual terminal app that provides access to Mail, Contacts, Calendar, and Journal, utilizing HEY's own keyboard shortcuts.
2. CLI Mode: A set of commands for reading threads, replying to emails, composing messages, searching, and managing events. It can output data in human-readable format or JSON for piping into other tools.
3. Agent Integration: It includes a setup wizard to connect with AI coding agents (such as Claude Code and Codex) and acts as an MCP (Model Context Protocol) server, providing the user's HEY account as a set of tools for the AI agent.

Who it’s for

• Developers who prefer working in the terminal and prefer to avoid switching contexts between their IDE and email/calendar.
• AI Agent users who want to give their coding agents the ability to read and write emails and manage calendar events.

Highlights

• Agent-Ready: Built-in support for Claude Code, Codex, and MCP server capabilities to empower AI agents.
• Live Sync: Syncs in real-time with the HEY email service (e.g., archiving a thread on a phone app will reflect in the the TUI).
• Flexible Output: Supports JSON output and built-in --jq filtering for easy scripting and automation.
• getline own tools: Provides specific commands for the imbox, screener, and other HEY-specific features.
• Diagnostic Tools: Includes hey doctor to verify installation, authentication, and agent setup.