# Ai Executive Assistant

> Your personal executive assistant that lives in your terminal. Built on Claude Code. Manages your day, tracks tasks, preps meetings, and keeps you accountable.

- **Type:** MCP server
- **Install:** `agentstack add mcp-cosmo-autom8s-ai-executive-assistant`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [cosmo-autom8s](https://agentstack.voostack.com/s/cosmo-autom8s)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [cosmo-autom8s](https://github.com/cosmo-autom8s)
- **Source:** https://github.com/cosmo-autom8s/ai-executive-assistant

## Install

```sh
agentstack add mcp-cosmo-autom8s-ai-executive-assistant
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# AI Executive Assistant

Your personal executive assistant that lives in your terminal. Built on [Claude Code](https://docs.anthropic.com/en/docs/claude-code).

Manages your day, tracks tasks, preps meetings, and keeps you accountable. Works with your existing tools or completely standalone.

## How It Works

The EA has three layers:

- **Skills** — 13 capabilities that define what the EA can do (morning brief, meeting prep, task capture, etc.)
- **Profile** — Who you are, how you work, what tools you use, and what the EA should watch for. Generated by `/ea-setup`.
- **Context** — The EA's working memory across sessions. Tracks today's plan, weekly goals, monthly focus, velocity, delegations, and decisions.

Skills tell the EA *what* to do. Your profile tells it *how* to do it for you specifically. Context files maintain state between conversations.

### The Daily Flow

```
Morning Brief → pulls calendar + tasks + email → today's plan
    ↓
Throughout day → add tasks, delegate, meeting prep as needed
    ↓
Afternoon Check-in → reviews progress → plans tomorrow
    ↓
Nightly Cleanup → organizes backlog → drafts tomorrow's plan
    ↓
Next morning → Morning Brief reads the draft as a head start
```

## What You Get

| Command | What it does |
|---------|-------------|
| `/ea` | Talk to your EA — think out loud, get advice, stay on track |
| `/ea-setup` | Personalize your EA — working style, tools, preferences |
| `/ea-morning-brief` | Start your day with an energy-optimized plan |
| `/ea-checkin` | Afternoon review — update progress, plan tomorrow |
| `/ea-night-cleanup` | End-of-day autopilot — organize tasks, draft tomorrow |
| `/ea-weekly-plan` | Monday planning — sprint goal, day-by-day slots |
| `/ea-weekly-retro` | Friday review — patterns, velocity, recommendations |
| `/ea-monthly-goals` | Set 3 focus areas with success criteria |
| `/ea-add-task` | Quick-capture a task (auto-sized, auto-categorized) |
| `/ea-delegate` | Hand off a task with follow-up tracking |
| `/ea-meeting-prep` | Pre-meeting brief — context, open items, questions |
| `/ea-plan-schedule` | Turn a brain dump into an organized schedule |

## Quick Start

### Prerequisites

- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed with an active Anthropic subscription

### The Easy Way (Non-Technical)

You don't need to understand any of the code below. Just open Claude Code and tell it:

> "Clone and install this for me: https://github.com/cosmo-autom8s/ai-executive-assistant"

Claude Code will handle the cloning and installation. Once it's done, restart Claude Code so the new commands take effect, then run `/ea-setup` to personalize your EA. The setup wizard walks you through everything: your working style, energy patterns, goals, and which tools to connect.

After setup, type `/ea` to start talking to your EA.

### Manual Install (Technical)

```bash
git clone https://github.com/cosmo-autom8s/ai-executive-assistant.git
cd ai-executive-assistant
./install.sh
```

Then restart Claude Code so the new commands are available, and run `/ea-setup` to personalize.

### Start Your Day

```
/ea-morning-brief
```

## Connecting Your Tools (Optional)

The EA works without any tools — it uses local context files and conversation out of the box. But connecting your tools makes it dramatically better.

You can connect:

| Tool Category | What it enables | Examples |
|---------------|----------------|----------|
| **Task Manager** | Task tracking, auto-sizing, daily plans from real data | Notion, Todoist, Linear, Asana |
| **Calendar** | Schedule-aware planning, meeting prep, free time detection | Google Calendar, Outlook |
| **Knowledge Base** | Daily context from your notes, energy awareness | Obsidian, Apple Notes |
| **Email** | Morning inbox scan, urgent item flagging | Gmail, Outlook |

### How to Connect

The `/ea-setup` wizard walks you through connecting each tool. You can also add tools anytime by asking Claude Code directly — just say something like "Connect my Notion" or "Add Google Calendar" and it'll guide you.

Under the hood, tools connect via MCP (Model Context Protocol) — an open standard that lets Claude Code talk to external services. If you're comfortable in the terminal, you can add them manually:

```bash
# General pattern
claude mcp add [tool-name] -- npx -y @anthropic-ai/claude-code-mcp-[tool-name]

# Examples
claude mcp add notion -- npx -y @anthropic-ai/claude-code-mcp-notion
claude mcp add google-calendar -- npx -y @anthropic-ai/claude-code-mcp-google-calendar

# Search for available tools
claude mcp search [tool-name]
```

But again — you can just ask Claude Code to do this for you. No need to memorize commands.

## Customization

- **Personality:** Edit `~/.claude/ea-profile.md` directly, or re-run `/ea-setup`
- **Skills:** Edit any `~/.claude/commands/ea-*.md` file to customize behavior
- **Add your own:** Create new `ea-*.md` files in `~/.claude/commands/` to extend the EA
- **Example profile:** See `config/example-personality.md` for inspiration on what a fully personalized profile looks like

## Updating

```bash
cd ai-executive-assistant
git pull
./install.sh
```

This updates all skills to the latest version. Your profile and context files are never overwritten.

## Uninstall

```bash
cd ai-executive-assistant
./uninstall.sh
```

You'll be asked whether to keep or remove your profile and context files.

## License

MIT — see [LICENSE](LICENSE)

## Credits

Built by [Cosmin "Cosmo" Lungu](https://autom8lab.com). Visit [Autom8Lab](https://autom8lab.com) for more agents, skills, and resources.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [cosmo-autom8s](https://github.com/cosmo-autom8s)
- **Source:** [cosmo-autom8s/ai-executive-assistant](https://github.com/cosmo-autom8s/ai-executive-assistant)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-cosmo-autom8s-ai-executive-assistant
- Seller: https://agentstack.voostack.com/s/cosmo-autom8s
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.