# Local Tools

Access local system resources including Calendar on macOS and Windows.

- Repository: https://github.com/netease-youdao/LobsterAI (6161 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add netease-youdao/LobsterAI --skill local-tools -g -a claude-code -y`
Codex: `npx skills add netease-youdao/LobsterAI --skill local-tools -g -a codex -y`
Cursor: `npx skills add netease-youdao/LobsterAI --skill local-tools -g -a cursor -y`
Gemini CLI: `npx skills add netease-youdao/LobsterAI --skill local-tools -g -a gemini-cli -y`

## Description

Access local system resources including Calendar on macOS and Windows. Use this skill when you need to manage user's schedule directly on their device.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Local Tools Skill

## When to Use This Skill

Use the local-tools skill when you need to:

- **Calendar Management** - View, create, update, or delete calendar events

**Examples of when to use:**
- User: "Show me my schedule for tomorrow"
- User: "Create a meeting at 3 PM"
- User: "Search for calendar events containing 'project'"
- User: "Delete tomorrow's meeting"

## How It Works

```
┌──────────┐    Bash/PowerShell    ┌─────────────────────────────────────────────────────────────┐
│  Claude  │──────────────────────▶│  calendar.sh / calendar.ps1                                 │
│          │                       │  ├─ macOS: osascript -l JavaScript (JXA) ──▶ Calendar.app   │
│          │                       │  └─ Windows: PowerShell ──▶ Outlook COM API                 │
└──────────┘                       └─────────────────────────────────────────────────────────────┘
```

**Architecture:**
1. **CLI Scripts** - Platform-specific scripts, no HTTP server needed
   - `calendar.sh` - Bash script for macOS
   - `calendar.ps1` - PowerShell script for Windows

2. **Local Calendar Access** - Direct access to system calendar
   - macOS: Uses JXA (JavaScript for Automation) to control Calendar.app
   - Windows: Uses PowerShell COM API to control Microsoft Outlook

3. **JSON Output** - Structured data format for easy parsing

## Platform Support

| Platform | Implementation | Calendar App | Status |
|----------|---------------|--------------|--------|
| **macOS 10.10+** | JXA + Calendar.app | Calendar.app | ✅ Fully Supported |
| **Windows 7+** | PowerShell + COM | Microsoft Outlook | ✅ Fully Supported |
| **Linux** | - | - | ❌ Not Supported |

## Permissions

### macOS
- Requires "Calendar" access permission
- User will be prompted on first use
- Can be managed in: System Settings > Privacy & Security > Calendar

### Windows
- Requires Microsoft Outlook to be installed
- May require administrative privileges for COM access

## Calendar Operations

The rest: https://github.com/netease-youdao/LobsterAI/blob/HEAD/SKILLs/local-tools/SKILL.md