| name | porteden |
| description | Secured Calendar and Email management - Gmail, Outlook & Exchange - list, search, create, update, delete calendar events and list, search, read, send, reply, forward, delete, modify emails across multiple accounts (gog-cli secure alternative). |
| homepage | https://porteden.com |
| metadata | {"openclaw":{"emoji":"🔗","requires":{"bins":"[Truncated]","env":"[Truncated]"},"primaryEnv":"PE_API_KEY","install":["[Truncated]","[Truncated]"]}} |
porteden
Use porteden for calendar and email management across multiple accounts. Use -jc flags for AI-optimized output.
If porteden is not installed: brew install porteden/tap/porteden (or go install github.com/porteden/cli/cmd/porteden@latest).
Setup (once)
- Browser login (recommended):
porteden auth login — opens browser, credentials stored in system keyring
- Direct token:
porteden auth login --token <key> — stored in system keyring
- Verify:
porteden auth status
- If
PE_API_KEY is set in the environment, the CLI uses it automatically (no login needed).
Calendar commands
- List calendars:
porteden calendar calendars -jc
- Events today (or --tomorrow, --week):
porteden calendar events --today -jc
- Events custom range:
porteden calendar events --from 2026-02-01 --to 2026-02-07 -jc
- All events (auto-pagination):
porteden calendar events --week --all -jc
- Search events:
porteden calendar events -q "meeting" --today -jc
- Events by contact:
porteden calendar by-contact "user@example.com" -jc (or --name "John Smith")
- Get single event:
porteden calendar event <eventId> -jc
- Create event:
porteden calendar create --calendar <id> --summary "Meeting" --from "..." --to "..." --location "Room A" --attendees "a@b.com,c@d.com"
- Update event:
porteden calendar update <eventId> --summary "New Title" (also: --from, --to, --location)
- Update attendees:
porteden calendar update <eventId> --add-attendees "new@example.com" (or --remove-attendees; add --notify to send notifications)
- Delete event:
porteden calendar delete <eventId> (add --no-notify to skip attendee notifications)
- Respond to invite:
porteden calendar respond <eventId> accepted (or: declined, tentative)
Event Status Values
confirmed - Accepted/scheduledtentative - Maybe attendingneedsAction - Requires response from usercancelled - Event was cancelled
Time Formats
- All times use RFC3339 UTC format:
2026-02-01T10:00:00Z
- For all-day events, use midnight-to-midnight with
--all-day flag
- JSON output includes
startUtc, endUtc, durationMinutes fields
Email commands
Use porteden email (alias: porteden mail) for email management.
- List emails (or --today, --yesterday, --week, --days N):
porteden email messages -jc
- Filter emails:
porteden email messages --from sender@example.com -jc (also: --to, --subject, --label, --unread, --has-attachment)
- Search emails:
porteden email messages -q "keyword" --today -jc
- Custom date range:
porteden email messages --after 2026-02-01 --before 2026-02-07 -jc
- All emails (auto-pagination):
porteden email messages --week --all -jc
- Get single email:
porteden email message <emailId> -jc
- Get thread:
porteden email thread <threadId> -jc
- Send email:
porteden email send --to user@example.com --subject "Hi" --body "Hello" (also: --cc, --bcc, --body-file, --body-type text, --importance high)
- Send with named recipient:
porteden email send --to "John Doe <john@example.com>" --subject "Hi" --body "Hello"
- Reply:
porteden email reply <emailId> --body "Thanks" (add --reply-all for reply all)
- Forward:
porteden email forward <emailId> --to colleague@example.com (optional --body "FYI", --cc)
- Modify email:
porteden email modify <emailId> --mark-read (also: --mark-unread, --add-labels IMPORTANT, --remove-labels INBOX)
- Delete email:
porteden email delete <emailId>
Notes
- Credentials persist in the system keyring after login. No repeated auth needed.
- Set
PE_PROFILE=work to avoid repeating --profile.
-jc is shorthand for --json --compact: filters noise, truncates fields, reduces tokens.- Use
--all to auto-fetch all pages; check hasMore/nextPageToken (email) or meta.hasMore/meta.totalCount (calendar) in JSON output.
- Calendar manual pagination:
--limit 100 --offset 0, then --offset 100, etc.
by-contact supports partial matching: "@acme.com" for email domain, --name "Smith" for name.- Email IDs are provider-prefixed (e.g.,
google:abc123, m365:xyz789). Pass them as-is.
--include-body on messages fetches full body (default: preview only). Single message includes body by default.--body and --body-file are mutually exclusive. Use --body-type text for plain text (default: html).- Confirm before sending, replying, forwarding, or deleting emails.
- Confirm before creating, updating, or deleting events.
- "invalid calendar ID": Get IDs with
porteden calendar calendars -jc.
- Environment variables:
PE_API_KEY, PE_PROFILE, PE_TIMEZONE, PE_FORMAT, PE_COLOR, PE_VERBOSE.
