email-api

Email API Manager Skill

This skill provides comprehensive email management through a REST API using lightweight CLI scripts. All operations are token-efficient and composable.

Configuration

Set the API base URL (defaults to https://agenskill-api.onrender.com):

export EMAIL_API_BASE_URL="https://agenskill-api.onrender.com"

Authentication

All email operations require authentication via headers:

• X-API-Key: Your API key (e.g., sk-email-api-742189hd023)
• X-User-Email: Your email address (used as sender and for access control)

Store credentials in a JSON file (e.g., email_credentials.json):

{
  "account": {
    "email": "[email protected]",
    "api_key": "sk-email-api-742189hd023"
  }
}

Load credentials in scripts:

API_KEY=$(cat email_credentials.json | jq -r '.account.api_key')
USER_EMAIL=$(cat email_credentials.json | jq -r '.account.email')

Usage Guidelines

1. Read Documentation On-Demand

When first using email API operations, read the comprehensive README:

cat ~/.claude/skills/email-api/README.md

This provides detailed usage examples for all operations.

2. Execute Scripts via Bash

All scripts are in the scripts/ directory and output JSON for easy parsing:

cd ~/.claude/skills/email-api/scripts

3. Parse JSON Output

All scripts return JSON. Parse the output and present relevant information to the user in a friendly format.

4. Chain Operations

Save intermediate results to files when chaining operations:

# Search for emails in inbox
node email-search.js --api-key "$API_KEY" --user-email "$USER_EMAIL" --folder inbox > /tmp/search-results.json

# Read first message from results
EMAIL_ID=$(cat /tmp/search-results.json | jq -r '.emails[0].id')
node email-read.js --api-key "$API_KEY" --user-email "$USER_EMAIL" --id "$EMAIL_ID"

Available Operations

Send Email

node email-send.js --api-key "$API_KEY" --user-email "$USER_EMAIL" --to "[email protected]" --subject "Subject" --body "Body text"