@thingsai/msft-todo-cli-mcp

A CLI-first tool for managing Microsoft To Do tasks, with an optional MCP server for AI agents.

⚠️ Experimental — This software is experimental and provided "as is" without warranty of any kind. Use at your own risk. See LICENSE for details.

Install

npm install -g @thingsai/msft-todo-cli-mcp

Quick Start

# 1. Set your Azure app client ID (see docs/azure-setup.md)
export TODO_MCP_CLIENT_ID="your-client-id"

# 2. Authenticate (opens browser)
todo setup

# 3. Use it
todo lists
todo tasks --list <listId>
todo tasks create --list <listId> --title "Buy milk" --due 2026-04-20
todo tasks complete --list <listId> --task <taskId>

MCP Server (for AI agents)

todo serve

Add to VS Code settings.json for Copilot integration:

{
  "mcp": {
    "servers": {
      "todo": {
        "command": "todo",
        "args": ["serve"],
        "env": { "TODO_MCP_CLIENT_ID": "your-client-id" }
      }
    }
  }
}

Documentation

• Getting Started — Install, authenticate, first commands
• Azure Setup — App registration via Portal or Azure CLI
• CLI Reference — Full command reference with examples
• MCP Integration — VS Code, Claude Desktop, tools table
• Configuration — Environment variables, token storage, CI setup
• Security — Encryption, PKCE, scopes, design decisions

License

MIT