jean-claude

A Claude Code plugin for managing Gmail, Google Calendar, Google Drive, and iMessage (macOS only).

Prerequisites

Claude Code

This is a plugin for Claude Code, Anthropic's agentic coding tool. Install it first:

curl -fsSL https://claude.ai/install.sh | bash

uv (Python package manager)

This plugin requires uv to manage Python dependencies (requires Python 3.11+, which uv will install automatically if needed):

curl -LsSf https://astral.sh/uv/install.sh | sh

Installation

From your terminal, run:

claude plugin marketplace add max-sixty/jean-claude
claude plugin install jean-claude@jean-claude

Setup

Google Workspace (Gmail, Calendar, Drive)

After installing the plugin, ask Claude to authenticate:

"Set up Google authentication for jean-claude"

Claude will run the auth command for you, which opens a browser for OAuth consent.

# The plugin is installed at:
cd ~/.claude/plugins/marketplaces/jean-claude

# Full access (read, send, modify)
uv run jean-claude auth

# Or read-only access (no send/modify capabilities)
uv run jean-claude auth --readonly

# Verify it worked
uv run jean-claude status

iMessage (macOS only)

iMessage integration requires macOS—it uses AppleScript and the local Messages database.

• Sending messages: Works via AppleScript. On first use, macOS prompts to allow your terminal to control Messages.app (Automation permission). Grant this to whichever app runs Claude Code (Terminal, iTerm2, VS Code, etc.).

• Reading messages: Requires Full Disk Access to read the Messages database.

  1. Open System Settings → Privacy & Security → Full Disk Access
  2. Click + and add the app that runs Claude Code:
     • If using Terminal: add /Applications/Utilities/Terminal.app
     • If using iTerm2: add /Applications/iTerm.app
     • If using VS Code: add /Applications/Visual Studio Code.app
     • If using another terminal: find it in /Applications or via which
  3. Toggle the app on and restart it

Usage

Once installed, Claude automatically uses this plugin when you ask it to:

• Search, send, or draft emails
• Check calendar or create events
• Find, upload, or share Drive files
• Send texts or check iMessages

Example Prompts

"Check my inbox for unread emails"
"What's on my calendar today?"
"Send an email to alice@example.com about the meeting"
"Search Drive for quarterly reports"
"Text +12025551234 that I'm running late"

cd ~/.claude/plugins/marketplaces/jean-claude
uv run jean-claude --help
uv run jean-claude gmail --help
uv run jean-claude gcal --help
uv run jean-claude gdrive --help
uv run jean-claude imessage --help  # macOS only

Shell Completions

Enable tab completion for the CLI:

cd ~/.claude/plugins/marketplaces/jean-claude

# Bash (~/.bashrc)
eval "$(uv run jean-claude completions bash)"

# Zsh (~/.zshrc)
eval "$(uv run jean-claude completions zsh)"

# Fish (~/.config/fish/config.fish)
uv run jean-claude completions fish | source

Features

Gmail

• Search and list emails
• Create, send, and manage drafts
• Reply and forward with threading preserved
• Star, archive/unarchive, mark read/unread, trash messages

Google Calendar

• List events (today, date range, or N days)
• Create events with attendees, location, description
• Search, update, and delete events
• Timezone auto-detection

Google Drive

• List and search files
• Upload and download files
• Create folders and share files
• Trash and restore files

iMessage (macOS only)

• Send messages to individuals or groups
• Send file attachments
• List chats and participants
• Search message history
• View unread messages

Security

• OAuth tokens are stored with 0600 permissions (owner read/write only)
• Default OAuth client credentials are embedded for convenience (standard practice for desktop/CLI apps per Google's guidelines)
• Users can provide their own Google Cloud credentials if preferred
• All email/message sends require explicit user approval

# Install with dev dependencies
uv sync

# Run tests
uv run pytest

# Run lints
pre-commit run --all-files

License

MIT