moms-executive-assistant

Mom's Executive Assistant (MEA)

Your life has a thousand moving parts. MEA tracks all of them.

MEA is a personal life task management plugin for Claude Cowork. It scans your Gmail (read-only), processes meeting notes, handles manual input, and turns everything into tracked tasks on a GitHub Projects board — your existing one, not a new app.

You interact with it through three interfaces:

• Cowork (chat commands) — the primary interface for everything
• GitHub Projects (visual board) — where all tasks live, accessible from any device
• Siri Shortcuts (voice) — add and complete tasks hands-free (Phase 3)

All your data is stored in systems you own — locally on your machine inside a Cowork Project, or in your own GitHub repo.

---

Current status: Phase 2 complete

Phase	Status	What it covers
Phase 1 — Foundation + Core Loop	✅ Complete	Email scanning (rule-based), manual task entry, task completion, daily briefing, health check
Phase 2 — Intelligence + Recurring	✅ Complete	Tier 2/3 LLM classification, recurring task engine, /onboard wizard, /add-recurring, daily maintenance task
Phase 3 — Meeting Notes + Voice	🟡 In progress	Meeting note extraction, Siri Shortcuts
Phase 4 — Weekly Review + Polish	Not started	Weekly review, advanced filtering, error handling
Phase 5 — Marketplace Prep	Not started	Config templates, packaged plugin

See AGENTS.md for the full phase tracker and contributor guide.

---

Prerequisites

Before you can use MEA, you need:

1. Claude Desktop with a Pro, Max, Team, or Enterprise plan (required for Cowork and integrations)
2. A Gmail account you want MEA to scan
3. A GitHub account with:
   • A repository to create issues in (can be private)
   • A GitHub Projects board associated with that repo (or your account)
   • Your project board number (the number in the URL: github.com/users/you/projects/5 → 5)

---

Installation

Step 1 — Clone this repo

git clone https://github.com/queen-of-code/executive-assistant
cd executive-assistant

This repo directory will become your MEA workspace — all state files live here (in task-data/, which is .gitignore'd).

Step 2 — Create a Cowork Project pointed at this folder

MEA relies on state files (task-data/mea-state.json, etc.) persisting between Cowork sessions. This requires running inside a Cowork Project — standalone Cowork sessions don't reliably persist local file writes.

1. Open Claude Desktop → switch to the Cowork tab
2. In the left sidebar, click Projects → +
3. Choose Use an existing folder
4. Select the executive-assistant/ directory you cloned in Step 1
5. Name it something like "MEA" and click Create

All MEA tasks — setup, scans, briefings — should be run from inside this project.

Step 3 — Connect Gmail (read-only)

MEA reads your email but never writes to it. The Gmail connector is scoped to gmail.readonly — it cannot send, archive, delete, or modify any email. See CONNECTORS.md for the full list of what is and isn't accessed.

1. Open Claude Desktop → Settings → Integrations
2. Click Connect Gmail
3. Sign in with the Google account(s) you want to scan
4. Authorize the read-only scope when prompted

Repeat for each Gmail account you want MEA to monitor.

Step 4 — Connect GitHub

1. Open Claude Desktop → Settings → Integrations
2. Click Connect GitHub
3. Authorize with the account that owns your tasks repo

Or, if you prefer a personal access token:

export GITHUB_TOKEN=ghp_your_token_here

The token needs repo scope (to create and read issues).

Step 5 — Install MEA as a plugin

Option A: Local install (development / personal use)

Inside Cowork, run:

/plugin marketplace add queen-of-code/executive-assistant
/plugin install moms-executive-assistant@queen-of-code

This adds the GitHub repo as a marketplace and installs the plugin from it.

Option B: Load directly without installing (quickest for testing)

Start Claude Code with the plugin directory:

claude --plugin-dir ./executive-assistant

Or inside an active Cowork session:

/plugin marketplace add ./executive-assistant
/plugin install moms-executive-assistant@executive-assistant

Note: Once the repo is public on GitHub, Option A is the cleanest path. For now (private repo), Option B works as long as you're authenticated.

Step 6 — Run the setup wizard

Inside your MEA Cowork Project, run:

/configure-mlea

This will ask you for:

• Your name and common name variants (used for meeting note matching in Phase 3)
• The Gmail address(es) to scan
• Your GitHub username, repo name, and Projects board number