jean-claude

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

[!NOTE] You may see an "unverified app" warning during OAuth—this is normal for apps pending Google verification. Click "Advanced" → "Go to jean-claude (unsafe)" to proceed. The app only requests the permissions you approve and stores credentials locally on your machine.

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 [email protected] 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)"