# Jmap Email

> Enables JMAP email operations using Node.js and jmap-jam library. Use when working with JMAP email servers, FastMail, Cyrus IMAP, Stalwart Mail Server, or when user mentions email search, reading, sending, or mailbox management.

- **Type:** Skill
- **Install:** `agentstack add skill-jacobrask-claude-skills-jmap-email`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [jacobrask](https://agentstack.voostack.com/s/jacobrask)
- **Installs:** 0
- **Category:** [Communication](https://agentstack.voostack.com/c/communication)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [jacobrask](https://github.com/jacobrask)
- **Source:** https://github.com/jacobrask/claude-skills/tree/main/skills/jmap-email

## Install

```sh
agentstack add skill-jacobrask-claude-skills-jmap-email
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# JMAP Email Access

Access JMAP email servers (FastMail, Cyrus IMAP, Stalwart) using pre-built scripts.

## Prerequisites

Environment variables must be set before launching Claude Code:
- `JMAP_SESSION_URL` - JMAP server session URL
- `JMAP_BEARER_TOKEN` - Authentication bearer token
- `JMAP_ACCOUNT_ID` - Account ID (optional, auto-detected)

## Available Scripts

**Choose the right script:**
- **Browse recent emails?** → Use `list-emails.ts` (supports --unread, --flagged, --mailbox, --from, --limit filters)
- **Search by sender?** → Use `list-emails.ts --from "sender@example.com"`
- **Search for multiple keywords?** → Use `search-keywords.ts keyword1 keyword2 ...`
- **Get full email content?** → Use `get-email.ts` with email ID
- **View folder structure?** → Use `list-mailboxes.ts`
- **Move emails by ID?** → Use `move-by-ids.ts --mailbox    ...`
- **Delete emails?** → Use `delete-emails.ts   ...`

All scripts support `--help` for detailed usage.

## Common Tasks

### Browse unread emails
```bash
node scripts/list-emails.ts --unread
node scripts/list-emails.ts --unread --limit 50
```

### Find emails from specific sender
```bash
node scripts/list-emails.ts --from "sender@example.com"
node scripts/list-emails.ts --from "sender@example.com" --unread
```

### Search for receipts or specific content
```bash
node scripts/search-keywords.ts "invoice" "receipt" "order confirmation"
node scripts/search-keywords.ts --mailbox "Archive" --limit 10 "meeting" "agenda"
```
Note: Search shows previews only. For full email content, use `get-email.ts` with the email ID.

### Get full email content
```bash
node scripts/get-email.ts 
```

### Organize emails (classification workflow)
1. Search for candidates: `search-keywords.ts "keyword1" "keyword2"`
2. Review previews and identify relevant email IDs
3. (Optional) View full content: `get-email.ts `
4. Move to target mailbox: `move-by-ids.ts --mailbox @MailboxName id1 id2 id3`

### Interactive email triage
**Workflow for processing new emails with learning:**

1. **Fetch recent emails:**
   - Use `list-emails.ts --limit 20` to get batch (optionally add `--unread` or `--mailbox "Inbox"`)
   - Review subject, sender, and preview

2. **Present classification options:**
   - Use AskUserQuestion with multiSelect for each email
   - Options should be target mailboxes (Inbox, Archive, @Reference, etc.)
   - Allow user to select destination for each email

3. **Execute moves:**
   - Group emails by target mailbox
   - Use `move-by-ids.ts --mailbox    ...` for each group

4. **Save routing patterns to memory:**
   - Note sender domains and subjects that map to specific mailboxes
   - Record user's classification decisions (e.g., "newsletters from X → Archive")
   - Reference these patterns in future triage sessions
   - Suggest automatic routing rules based on observed patterns

**Benefits:**
- Process inbox in batches with interactive guidance
- Build up routing knowledge over time
- Suggest classifications based on past decisions
- Gradually automate common routing patterns

### View mailbox structure
```bash
node scripts/list-mailboxes.ts
```

## Output Format

Scripts output compact, human-readable results:
```
Found 5 email(s) (unread)
================================================================================

⭐ [UNREAD] Meeting tomorrow
From: John Doe 
Date: 1/15/2024, 10:30:45 AM
ID: StrgucNsyw-3
Preview: Hi Jane, let's meet at 2pm to discuss the project...
--------------------------------------------------------------------------------
```

## Advanced Usage

For writing custom JMAP operations or understanding the API, see:
- **Code Examples**: [examples.md](examples.md)
- **API Reference**: [reference.md](reference.md)
- **Development Guide**: [DEVELOPMENT.md](DEVELOPMENT.md)

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [jacobrask](https://github.com/jacobrask)
- **Source:** [jacobrask/claude-skills](https://github.com/jacobrask/claude-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-jacobrask-claude-skills-jmap-email
- Seller: https://agentstack.voostack.com/s/jacobrask
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.