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.17.tar.gz (72.9 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.17-py3-none-any.whl (93.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mccloud_organizer-0.2.17.tar.gz
  • Upload date:
  • Size: 72.9 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.17.tar.gz
Algorithm Hash digest
SHA256 05c23e04d81030f3e48dfc143ff0e0dbef1d59a88ba7ee662f1f5e2475ecd5b2
MD5 9c41b95f83512b72c10bf76db055e97b
BLAKE2b-256 304de29c117cb8d92fdd426ec2bc21245a215db2459c32e4edf8134a75385805

See more details on using hashes here.

Provenance

The following attestation bundles were made for mccloud_organizer-0.2.17.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.17-py3-none-any.whl.

File metadata

File hashes

Hashes for mccloud_organizer-0.2.17-py3-none-any.whl
Algorithm Hash digest
SHA256 f457d49a6ce56514df9f615f742cde79d8935499aad7a0f22eab77c3d7f45899
MD5 25be5850efb9ccc6f289f904f1ca55d7
BLAKE2b-256 d7c79ada9cd8b579f6d4654c2dd07d6f9649162f9ed90e817bb60ae482f90d75

See more details on using hashes here.

Provenance

The following attestation bundles were made for mccloud_organizer-0.2.17-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