mccloud

Personal AI assistant — TUI and CLI, powered by Claude.

Connects Slack threads, GitHub PRs, Google Calendar, and Apple Reminders in one place.

Install

pipx install mccloud-assistant

From source

git clone https://github.com/stephen-daq/mccloud
cd mccloud
make install

TUI

mccloud

CLI

All commands work without opening the TUI.

Auth status

mccloud status

Slack

# Send a DM
mccloud send --to "Name" --message "hello"
mccloud send --to "Name" report.pdf
mccloud send --to "Name" --message "here you go" a.pdf b.pdf
mccloud send --list-users          # see available users

# Threads
mccloud threads                    # list active threads (full content)
mccloud threads --recent 5         # show only the 5 most recent
mccloud threads --ids              # show IDs (needed for done/delete)
mccloud threads done <id>          # mark complete
mccloud threads delete <id>        # delete
mccloud threads save <slack-url>   # save a thread by message link
mccloud threads new --to "Name" --message "hi"

GitHub PRs

mccloud prs                        # list tracked PRs with live status
mccloud prs --open                 # open PRs only
mccloud prs --no-status            # skip GitHub API (fast)
mccloud prs --refresh              # bypass cache

mccloud track https://github.com/owner/repo/pull/123
mccloud untrack https://github.com/owner/repo/pull/123

Calendar

mccloud calendar                   # today's events
mccloud calendar --week            # this week
mccloud calendar --days 3          # next N days
mccloud calendar --date 2026-05-22

Reminders

mccloud reminders                  # list incomplete reminders
mccloud reminders add "Call Alex" --due 2026-05-22 --notes "re: Q3 plan"
mccloud reminders done 2           # mark index 2 complete
mccloud reminders delete 2         # delete index 2

Claude Code integration

McCloud ships a Claude Code skill that lets Claude read and act on your real data directly from any conversation.

Install the skill

mccloud install-claude

This copies the skill into ~/.claude/skills/mccloud/. Restart Claude Code (or start a new session) to activate it. The skill auto-updates whenever you run mccloud after a pipx upgrade.

Available skills

Once installed, use these in any Claude Code session:

You can also ask Claude naturally — "what's on my calendar this week", "add a reminder to...", "show me my Slack threads" — and it will use the mccloud CLI automatically.

Slack slash commands

Install the mccloud Slack app to use these in any channel:

• /save — save the current thread
• /save <message-link> — save a specific thread
• /track — track the GitHub PR linked in the latest message
• /track <pr-url> — track a specific PR

Connecting integrations

Run mccloud and open the Config tab to connect:

• Slack — OAuth
• GitHub — OAuth
• Google Calendar — OAuth

Credentials are stored locally at ~/.mccloud/.