Porteden Email

Name: Porteden Email
Author: bighardperson

bighardperson/computer-science-skills-collection

8 installs
33 repo stars
Updated April 26, 2026
bighardperson/computer-science-skills-collection

Porteden-email is a skill that manages Gmail, Outlook, and Exchange email through the porteden CLI, supporting list, search, send, reply, forward, and modify.

About

Porteden-email is an email-management skill that drives the porteden CLI to work with Gmail, Outlook, and Exchange across multiple accounts. It can list, search, read, send, reply, forward, delete, and modify emails, with an AI-optimized JSON output mode. A developer or agent uses it to handle email programmatically without hardcoding credentials.

CLI email management across Gmail, Outlook, and Exchange accounts
List, search, read, send, reply, forward, delete, and modify emails
AI-optimized -jc output; credentials stored in the system keyring

Porteden Email by the numbers

8 all-time installs (skills.sh)
Ranked #1,522 of 2,719 Automation & Workflows skills by installs in the Skillselion catalog
Data as of Jul 30, 2026 (Skillselion catalog sync)

At a glance

porteden-email capabilities & compatibility

Requires a porteden account and PE_API_KEY or login; external service.

Capabilities: email
Works with: gmail · outlook
Use cases: email
Runs: Runs locally
Pricing: Bring your own API key

From the docs

What porteden-email says it does

Secured Email Mnagement - Gmail, Outlook & Exchange - list, search, read, send, reply, forward, delete, and modify emails across multiple accounts (gog-cli secure alternative).

SKILL.md

Credentials persist in the system keyring after login. No repeated auth needed.

SKILL.md

npx skills add https://github.com/bighardperson/computer-science-skills-collection --skill porteden-email

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/skills/bighardperson/computer-science-skills-collection/porteden-email.svg)](https://skillselion.com/skills/bighardperson/computer-science-skills-collection/porteden-email)

Installs	8
repo stars	★ 33
Last updated	April 26, 2026
Repository	bighardperson/computer-science-skills-collection ↗

What it does

Manage Gmail, Outlook, and Exchange email from the CLI: list, search, send, reply, forward, and modify.

Who is it for?

Programmatic email across Gmail, Outlook, and Exchange with keyring-stored credentials

Skip if: Non-porteden mail providers or clients without the porteden CLI installed

When should I use this skill?

A user asks to send, receive, search, or modify email across their accounts

What you get

Emails listed, searched, sent, replied, forwarded, or modified via the porteden CLI.

email list, message, and thread output
sent and modified emails

By the numbers

3 supported mail platforms: Gmail, Outlook, Exchange

Files

SKILL.mdMarkdownGitHub ↗

porteden email

Use porteden email (alias: porteden mail) for 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).

Common commands

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: strips attachment details, truncates body previews, limits labels, reduces tokens.
Use --all to auto-fetch all pages; check hasMore and nextPageToken in JSON output.
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.
Environment variables: PE_API_KEY, PE_PROFILE, PE_TIMEZONE, PE_FORMAT, PE_COLOR, PE_VERBOSE.