Skip to main content

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

Metadata

Release files for mccloud-organizer 0.2.17

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mccloud-organizer 0.2.17
File Size Uploaded
mccloud_organizer-0.2.17.tar.gz 72.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mccloud-organizer 0.2.17
File Interpreter ABI Platform
mccloud_organizer-0.2.17-py3-none-any.whl Python 3 none any Details

Total release size: 166.1 kB

Release files / mccloud_organizer-0.2.17.tar.gz

Download URL mccloud_organizer-0.2.17.tar.gz
Size 72.9 kB
Tags Source
SHA-256 checksum
How to use checksums
05c23e04d81030f3e48dfc143ff0e0dbef1d59a88ba7ee662f1f5e2475ecd5b2
BLAKE2b-256 checksum
How to use checksums
304de29c117cb8d92fdd426ec2bc21245a215db2459c32e4edf8134a75385805
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 2, 2026.

Transparency log

Release files / mccloud_organizer-0.2.17-py3-none-any.whl

Download URL mccloud_organizer-0.2.17-py3-none-any.whl
Size 93.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f457d49a6ce56514df9f615f742cde79d8935499aad7a0f22eab77c3d7f45899
BLAKE2b-256 checksum
How to use checksums
d7c79ada9cd8b579f6d4654c2dd07d6f9649162f9ed90e817bb60ae482f90d75
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jun 2, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.2.17 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page