Skip to main content

McCloud — personal organizer TUI for Slack, GitHub, Calendar, and Reminders

Project description

mccloud

Personal organizer — TUI and CLI for Slack, GitHub, Calendar, and Reminders.

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

Install

pipx install mccloud-organizer

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:

Skill What it does
/mccloud overview Prioritized briefing: overdue reminders, today's calendar, open PRs, recently merged
/mccloud update reminders Converts active Slack threads into reminders, then marks threads done
/mccloud what now Opinionated recommendation on what to focus on right now

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/.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mccloud_organizer-0.2.15.tar.gz (72.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mccloud_organizer-0.2.15-py3-none-any.whl (92.4 kB view details)

Uploaded Python 3

File details

Details for the file mccloud_organizer-0.2.15.tar.gz.

File metadata

  • Download URL: mccloud_organizer-0.2.15.tar.gz
  • Upload date:
  • Size: 72.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for mccloud_organizer-0.2.15.tar.gz
Algorithm Hash digest
SHA256 55e33251396fc19a05aa3578772a6778e669734a6c8c13bf2868b8625672c290
MD5 6f439432afdf004300b6db8c296034cc
BLAKE2b-256 f78493e11747747b3a2d2ff469bd667ba607491fdd59f5124254958fc5880e59

See more details on using hashes here.

Provenance

The following attestation bundles were made for mccloud_organizer-0.2.15.tar.gz:

Publisher: publish.yml on stephen-daq/mccloud

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mccloud_organizer-0.2.15-py3-none-any.whl.

File metadata

File hashes

Hashes for mccloud_organizer-0.2.15-py3-none-any.whl
Algorithm Hash digest
SHA256 59ec2e8157dba6055e824414ada9495cd39804f57a4dcc39d04cd1eb3d8fa679
MD5 24395830b547925e4a9b62921c4f24eb
BLAKE2b-256 f9c677233e50f5ee95926d786b29ab77bd94b45b3433a79a0b287a7de00d514c

See more details on using hashes here.

Provenance

The following attestation bundles were made for mccloud_organizer-0.2.15-py3-none-any.whl:

Publisher: publish.yml on stephen-daq/mccloud

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page