Skip to content
LiveNew tools this week
Submit
AIMarketly
cli-executor logo

cli-executor

Execute CLI commands and skills from Desktop including outlook-extractor, git operations, and filesystem automation

mattnigh/skills_collection0installs24stars

SKILL.md

Full skill instructions

CLI Executor

Bridge Desktop to CLI capabilities using the claude-cli-executor MCP server powered by Claude Agent SDK.

What This Skill Does

Enables Claude Desktop to access all Claude CLI capabilities:

  • ✅ Outlook operations (emails, calendar, contacts, send, meetings)
  • ✅ Git operations (commit, push, pull, branch management)
  • ✅ Filesystem operations (direct file manipulation, faster than MCP)
  • ✅ Bash commands (grep, find, sed, complex scripts)
  • ✅ CLI skills (outlook-extractor, extract-epiroc-bev-report, etc.)

When to Use

Trigger this skill when user asks to:

  • Extract or send Outlook emails
  • Create or delete calendar meetings
  • Run git operations
  • Execute bash/​terminal commands
  • Run any CLI skill by name

Example triggers:

  • "Extract my emails from the past week"
  • "Send an email to Sipho about the BEV project"
  • "Create a meeting for tomorrow at 2pm"
  • "Commit these changes to git"
  • "Use outlook-extractor to find emails about fire safety"

How It Works

Uses the claude-cli-executor MCP tool: run_cli_session

Flow:

Desktop → MCP Tool → Claude Agent SDK → CLI Session → Windows/​Outlook → Result

Authentication: Uses your Claude subscription via claude login (no API credits)

Common Operations

Outlook: Extract Emails

User says: "Extract emails from the past week"

Action:

run_cli_session({
  "prompt": "Run the outlook extractor: python .claude/​skills/​outlook-extractor/​scripts/​outlook_extractor.py emails --days 7 --limit 50"
})

Outlook: Extract from Specific Folder

User says: "Show me emails from my Production folder"

Action:

run_cli_session({
  "prompt": "Run outlook extractor with folder search: python .claude/​skills/​outlook-extractor/​scripts/​outlook_extractor.py emails --folder-search 'Production' --days 14"
})

Outlook: Send Email

User says: "Send an email to Sipho about the N3 production meeting"

Important: Always draft first, get approval, then send!

Action:

run_cli_session({
  "prompt": "Run outlook extractor to send email: python .claude/​skills/​outlook-extractor/​scripts/​outlook_extractor.py send-email --to [email protected] --subject 'N3 Production Meeting' --body '[draft message]'"
})

Outlook: Create Meeting

User says: "Create a meeting tomorrow at 2pm with Xavier about BEV fire safety"

Action:

run_cli_session({
  "prompt": "Run outlook extractor to create meeting: python .claude/​skills/​outlook-extractor/​scripts/​outlook_extractor.py create-meeting --subject 'BEV Fire Safety Review' --start '2025-12-01 14:00' --attendees '[email protected]' --location 'Conference Room'"
})

Remember: Times are in SAST (UTC+2)

Outlook: List Calendar

User says: "What meetings do I have this week?"

Action:

run_cli_session({
  "prompt": "Run outlook extractor calendar: python .claude/​skills/​outlook-extractor/​scripts/​outlook_extractor.py calendar --days 7"
})

Git: Commit Changes

User says: "Commit my vault changes with message 'Updated BEV notes'"

Action:

run_cli_session({
  "prompt": "Commit all changes with message: git add . && git commit -m 'Updated BEV notes'"
})

File Operations

User says: "List all markdown files in the tasks directory"

Action:

run_cli_session({
  "prompt": "List markdown files in tasks/"
})

Outlook-Extractor Script Location

Script path: .claude/​skills/​outlook-extractor/​scripts/​outlook_extractor.py

Available commands:

  • emails --days N --limit N - Extract recent emails
  • emails --folder-search "Name" - Search in specific folder
  • calendar --days N - List calendar events
  • contacts - List contacts
  • search-contact "Name" - Find specific contact
  • send-email --to EMAIL --subject TEXT --body TEXT - Send email
  • create-meeting --subject TEXT --start DATETIME --attendees EMAIL - Create meeting
  • delete-meeting --subject TEXT --start DATETIME - Delete meeting

Full documentation: .claude/​skills/​outlook-extractor/​SKILL.md

Email Style Guide

When composing emails, follow Greg's style:

  • Greeting: "Hi [Name]" (colleagues) or "Good morning" (formal)
  • Structure: Short paragraphs (1-3 sentences), blank lines between
  • Tone: Direct, professional, action-oriented
  • Closing: Always "Regards" + "Greg"
  • @ Mentions: Use for specific actions: "@Xavier please review"

Always draft emails for user approval before sending!

Common Contacts

Quick reference for email addresses:

NameEmailRole
Rudi Opperman[email protected]Operations Manager
Jacques Breet[email protected]Engineering Manager
Sipho Dubazane[email protected]Engineer - Gloria
Sikelela Nzuza[email protected]Engineer - N2
Sello Sease[email protected]Engineer - N3
Xavier Petersen[email protected]Engineer - S&W

Technical Notes

MCP Server: claude-cli-executor

Location: C:\Users\10064957\.claude\mcp-servers\claude-cli-executor\server.py

Tool: run_cli_session(prompt, context_files?)

Technology: Claude Agent SDK (uses your Claude subscription via claude login)

Working Directory: C:\Users\10064957\My Drive\GDVault\MarthaVault

Logs: ~/​.claude/​mcp-servers/​claude-cli-executor/​server.log

Authentication

No API key needed! Uses Claude Code authentication:

claude login  # One-time setup

This uses your Claude subscription (Pro/​Max/​Team/​Enterprise).

Approval Workflow

Operations requiring approval:

  • ✅ Sending emails (ALWAYS draft first)
  • ✅ Creating meetings (confirm details)
  • ✅ Deleting content (verify before execution)
  • ✅ Git push operations (review changes)
  • ✅ Python script execution (security)

Auto-approved operations:

  • ✅ Reading emails/​calendar
  • ✅ Searching contacts
  • ✅ Listing files
  • ✅ Extracting data

The CLI will ask for approval when needed. You'll see exactly what it wants to do before execution.

Error Handling

If MCP tool fails:

  1. Check if Claude CLI is installed: claude --version
  2. Check if logged in: claude login
  3. Check server logs: ~/​.claude/​mcp-servers/​claude-cli-executor/​server.log
  4. Verify Outlook is running (for outlook-extractor)

If Outlook operations fail:

  • Ensure Outlook is open and running
  • Verify pywin32 installed: pip install pywin32 --upgrade
  • Check timezone (use SAST times: UTC+2)
  • Verify script path: .claude/​skills/​outlook-extractor/​scripts/​outlook_extractor.py

Response Format

The MCP returns conversation transcripts showing:

  • What CLI did step-by-step
  • Any approvals needed
  • Files modified
  • Commands executed
  • Final results

Extract the key information from the response and present it clearly to the user.

Examples in Action

Example 1: Email Extraction

User: "Extract my emails from this week"

Claude calls:

run_cli_session({
  prompt: "Run outlook extractor: python .claude/​skills/​outlook-extractor/​scripts/​outlook_extractor.py emails --days 7 --limit 50"
})

CLI response includes:

  • List of emails with subjects, senders, dates
  • Any approval requests (for Python execution)
  • Status of execution

Claude presents: Clean summary of important emails to user

Example 2: Meeting Creation

User: "Schedule BEV review Monday 2pm with the team"

Claude:

  1. Identifies attendees from context
  2. Calls MCP with create-meeting command
  3. Shows user the meeting details for approval
  4. After approval, confirms creation

Example 3: Git Commit

User: "Commit my changes with message 'Updated fire safety docs'"

Claude calls:

run_cli_session({
  prompt: "git add . && git commit -m 'Updated fire safety docs'"
})

CLI may require approval for git operations, then executes and confirms.

Status

✅ Production Ready

  • MCP server: Tested and working
  • Outlook extraction: Functional (requires approval)
  • Git operations: Functional (requires approval)
  • File operations: Functional

Important Reminders

  1. Always use the full script path: .claude/​skills/​outlook-extractor/​scripts/​outlook_extractor.py
  2. CLI skills are NOT auto-detected - must run Python scripts directly
  3. Approval is required for Python execution and sensitive operations
  4. Extract meaningful information from CLI responses - don't just show raw output
  5. Draft emails first - never send without user approval
  6. Times in SAST - UTC+2 for South Africa

This bridge gives you the full power of Claude CLI from Desktop!