CLI-First macOS Automation: Building an AI Agent-Friendly Productivity Toolchain

This article introduces a CLI productivity toolset for macOS that supports automated operations for Apple Mail, Calendar, and Reminders. It provides JSON output, batch processing mode, and an MCP adapter, laying the foundation for AI agent integration. The tool aims to address the limitations of traditional automation solutions through a CLI-first design, helping users build AI-friendly productivity workflows.

In an era dominated by graphical interfaces, CLI tools have experienced a revival due to AI agents' demand for structured text. Traditional macOS automation solutions (AppleScript/Shortcuts) have issues such as limited composability, inconsistent output formats, and difficulty with version control. In contrast, CLI tools offer advantages like standardized input/output, structured JSON data, version control, and remote-friendliness.

The tool adopts a "CLI-first, AI-friendly" design philosophy. Key AI integration features include: MCP adapter (standardizes communication between AI and the tool), security controls (operation confirmation, rate limiting, undo functionality), and structured JSON output (easy for AI to understand and process). The goal is to become the "digital limbs" of AI agents.

Core Features:

• Mail: Query search, batch operations, draft management, attachment handling;
• Calendar: Event querying/creation, conflict detection, batch updates;
• Reminders: List management, task operations, intelligent queries, batch processing. Usage Modes:
• REPL mode: Interactive exploration and debugging;
• Batch processing mode: Execute multiple operations (scheduled tasks/AI calls);
• Pipelining: Unix philosophy, collaborating with other tools (e.g., converting emails to to-dos as in the example).

AI Integration Practices: Integration with Claude Code via the MCP adapter. Typical workflows include meeting preparation assistant, inbox zero cleanup, and weekly review automation. Security Assurance: Follows the principle of least privilege, operation audit logs, supports undo scripts, provides a read-only sandbox mode, and protects sensitive data.

Extension Capabilities: Modular plugin architecture supports adding new services (e.g., Notes/Contacts), custom output formats, and integration with third-party services (Notion/Todoist). Configuration Management: Multi-level configuration (system/user/project/environment variables/command-line parameters) for flexible adaptation to different scenarios.

This tool represents a new direction for personal productivity tools. By collaborating with AI agents via CLI interfaces, it replaces isolated graphical applications. It helps users automate repetitive administrative tasks and focus on creative work. For developers, it is a foundational tool for building personal AI workflows, worth researching and extending.