gmail-skill

1# Gmail Manager Skill
2 
3This skill provides comprehensive Gmail integration through lightweight CLI scripts. All operations are token-efficient and composable.
4 
5## First-Time Setup
6 
7Before using this skill, you must set up OAuth authentication:
8 
91. **Install dependencies:**
10   ```bash
11   cd ~/.claude/skills/gmail-skill && npm install
12   ```
13 
142. **Set up Google Cloud credentials:**
15   - Follow the guide in `docs/google-cloud-setup.md`
16   - Download `credentials.json` and save to `scripts/auth/credentials.json`
17 
183. **Authenticate:**
19   ```bash
20   cd ~/.claude/skills/gmail-skill && npm run setup
21   ```
22 
23This will open a browser for Google OAuth and save your token locally.
24 
25## Multi-Account Support
26 
27The Gmail skill supports multiple accounts (e.g., personal and work email):
28 
29### Add Additional Accounts
30 
31```bash
32# Add a second account (from skill directory)
33npm run setup -- --account work
34 
35# Add a third account
36npm run setup -- --account personal
37```
38 
39Each account needs separate OAuth authentication.
40 
41### Manage Accounts
42 
43```bash
44# List all configured accounts
45node scripts/manage-accounts.js --list
46 
47# Set default account (used when --account is not specified)
48node scripts/manage-accounts.js --set-default work
49 
50# Remove an account
51node scripts/manage-accounts.js --remove old-account
52```
53 
54### Using Specific Accounts
55 
56All Gmail operations support the `--account` parameter:
57 
58```bash
59# Send email from work account
60…