mailtool

# Mailtool Plugin for Claude Code

This is the Claude Code plugin for [mailtool](https://github.com/utsmok/mailtool), which provides Outlook integration via MCP.

## Installation

### Via Claude Code Marketplace (Recommended)

```bash
/plugin marketplace add utsmok/mailtool-plugin
/plugin install mailtool
```

This will automatically:
- Configure the MCP server using `uvx mailtool` (no installation needed!)
- Install the Daily Planner skill for intelligent daily planning

## What's Included

### MCP Server (24 tools)

The plugin configures mailtool as an MCP server with tools for:
- 📧 **Email** (10 tools): List, read, send, reply, forward, mark, move, delete, search
- 📅 **Calendar** (7 tools): List, create, get, edit, respond to meetings, check free/busy
- ✅ **Tasks** (7 tools): List, create, get, edit, complete, delete tasks

### Daily Planner Skill

An intelligent assistant that:
- Analyzes your calendar, tasks, and emails
- Creates actionable daily plans with priorities
- Provides interactive walkthrough for email responses
- Suggests task execution order
- Offers proactive insights

## How It Works

This plugin is just a thin wrapper that:
1. Configures Claude Code to connect to the mailtool MCP server
2. Uses `uvx` to run `mailtool` without requiring installation
3. Bundles the Daily Planner skill for enhanced productivity

The actual Python package is published separately on PyPI as [mailtool](https://pypi.org/project/mailtool/).

## Requirements

- Windows with Outlook installed and running
- `uv` installed (for `uvx` command)
  - Install via: `curl -LsSf https://astral.sh/uv/install.sh | sh` (Linux/WSL2)
  - Or: `powershell -c "irm https://astral.sh/uv/install.ps1 | iex"` (Windows)

## Usage Examples

Once installed, you can:

```
# Check your daily plan
Plan my day

# Show unread emails
Show me my last 5 unread emails

# Create a task
Create a task "Review Q1 report" due Friday with high priority

# Schedule a meeting
Schedule a team meeting for tomorrow at 2pm in Room 101

# Accept a meeting invitation
Accept the meeting invitation from John

# Check your calendar
What"s on my calendar this week?
```

## Development

This plugin repo contains only configuration files. For development:

- **Python package**: [utsmok/mailtool](https://github.com/utsmok/mailtool)
- **This plugin**: [utsmok/mailtool-plugin](https://github.com/utsmok/mailtool-plugin)

## License

MIT

## Author

Sam (utsmok)