@addys/cli

Addys CLI and MCP server — manage tasks, drafts, chat, and integrations from the terminal or any MCP client (Claude Desktop, Claude Code, etc.).

Install

npm install -g @addys/cli

Or use directly with npx:

npx @addys/cli --help

Authentication

Login stores credentials at ~/.config/pma/credentials.json (chmod 600):

pma auth login -u [email protected] -p YourPassword1!
pma auth whoami
pma auth status
pma auth logout

CLI Commands

Tasks

pma tasks list                          # List all meetings
pma tasks list --meeting <meeting_id>   # List tasks for a meeting
pma tasks get <task_id>                 # Get a single task
pma tasks patch <task_id> --status done # Update task fields

Drafts

pma drafts get <draft_id>
pma drafts patch <draft_id> --content '{"subject":"Hi","body":"..."}'
pma drafts send <draft_id>

Chat (Agent Interaction)

pma chat list <task_id>              # Show chat history
pma chat send <task_id> "Do this"    # Send message, stream response
pma chat clear <task_id>             # Clear history

Integrations

pma integrations status              # List connected services
pma integrations connect SLACK       # Get OAuth URL
pma integrations disconnect <id>     # Remove connection

MCP Server

pma mcp serve                        # Start stdio MCP server (default)

MCP Integration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "pma": {
      "command": "npx",
      "args": ["@addys/cli", "mcp", "serve"]
    }
  }
}

Claude Code

Add to .claude/settings.json:

{
  "mcpServers": {
    "pma": {
      "command": "npx",
      "args": ["@addys/cli", "mcp", "serve"]
    }
  }
}

Available MCP Tools

| Tool | Description | |------|-------------| | pma_task_patch | Update task title, status, action, context | | pma_draft_patch | Update draft content | | pma_draft_send | Send a draft (email, calendar, slack) | | pma_chat_send | Send message to the PMA agent | | pma_chat_clear | Clear task chat history | | pma_integration_connect | Connect OAuth service | | pma_integration_disconnect | Remove integration |

Available MCP Resources

| URI | Description | |-----|-------------| | pma://meetings | All meetings with task counts | | pma://meetings/{id}/tasks | Tasks for a specific meeting | | pma://tasks/{id} | Single task detail | | pma://tasks/{id}/chat | Chat history for a task | | pma://drafts/{id} | Single draft | | pma://integrations | Connected services |

Available MCP Prompts

| Prompt | Description | |--------|-------------| | pma_task_summary | Summary of all tasks across meetings | | pma_meeting_review | Review tasks for a specific meeting |

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | PMA_BACKEND_URL | Production API Gateway | Override backend URL | | PMA_AGENT_URL | http://localhost:8080 | Override agent URL | | XDG_CONFIG_HOME | ~/.config | Override config directory |

Development

pnpm --filter @addys/cli dev          # Watch mode
pnpm --filter @addys/cli test         # Run tests
pnpm --filter @addys/cli test:watch   # Watch tests