Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Email Integration

Scan your email inbox during the morning routine. Extract action items, flag replies needed, and surface anything time-sensitive.

Prerequisites

An MCP connector for your email provider. Current options:

  • Gmail: Available as a Cowork connector. Provides search, read message, read thread.
  • Fastmail / JMAP: Via @jahfer/jmap-mcp-server (npm package). Read-only.
  • Other providers: If your provider supports IMAP, you may find community MCP servers. Check the MCP server directory.

JESSE.md Configuration

Add email scanning to your start-of-day routine in the Gather phase:

2. **Scan email inbox** -- Check your-email@example.com for action items,
   replies, and updates. Scan all messages (read and unread) -- if it's
   still in the inbox, it's not done.

And in the Process phase:

10. **Extract TODOs from email** -- New action items go into the
    appropriate project files and Dashboard.md.

The “Still in Inbox” Rule

The simplest email triage rule: if a message is still in your inbox, it hasn’t been handled. This means you need to archive or move emails once you’ve dealt with them (in your email client, not in the vault). Jesse treats every inbox message as potentially actionable.

Multiple Email Accounts

If you have separate work and personal email, add a step for each:

2. **Scan work email** -- Check work@company.com for action items.
3. **Scan personal email** -- Check personal@example.com for bills,
   appointments, and anything time-sensitive.

Personal email scanning often surfaces things like: utility bills, medical appointment reminders, subscription renewals, shipping notifications, and school communications.

What Jesse Does With Email

During the morning routine, Jesse:

  1. Reads recent inbox messages
  2. Identifies action items (things that need a response or a task)
  3. Creates TODO entries in the appropriate project files and Dashboard.md
  4. Flags anything time-sensitive in the morning briefing
  5. Notes relevant context for today’s meetings

Jesse does NOT send, reply to, or archive emails. That’s your job. Jesse reads and extracts.

Tips and Gotchas

Keep your inbox manageable. If you have thousands of unread emails, Jesse will waste time scanning irrelevant messages. Archive what’s done. The system works best when your inbox is a genuine queue of unprocessed items.

Be specific about what matters. If you get a lot of newsletters or automated notifications, tell Jesse to skip them:

When scanning email, skip: newsletters, automated notifications from
GitHub/Jira/etc, marketing emails. Focus on messages from people
that need a response or contain action items.

The Fastmail JMAP connector has rough edges. Jeremy found and fixed several bugs in the existing npm package and submitted a PR upstream. If you use Fastmail, expect some iteration.