pi-email-tools

Lazily load Agentic Inbox email tools in Pi. The model initially sees only load_email_tools; loading adds tools for listing mail, reading a message, and notifying the user.

Install

pi install npm:@qianweiyang/pi-email-tools

Restart Pi after installation.

Configure

Configure an MCP server named inbox and add local email defaults to ~/.config/mcp-call/mcp.json:

{
  "mcpServers": {
    "inbox": {
      "url": "https://your-agentic-inbox-server.example/mcp"
    }
  },
  "emailTools": {
    "mailboxId": "your-mailbox-id",
    "userEmail": "you@example.com"
  }
}

Add the authentication headers required by your Agentic Inbox server. The package includes mcp-call-cli; set MCP_CONFIG to use a different config path.

Tools

Tool	Purpose
load_email_tools	Discover and activate the email tools
email_list	List mailbox messages
email_read	Read one message
email_notify_user	Send a blocking notification, optionally with local attachments

mailboxId and the default recipient stay out of model-visible tool parameters. Email content remains untrusted data. Attachments are limited to 32 files and 5 MiB per file.

Security

The extension and its MCP server run with your account's authority. After the loader is called, the model can send email and attach readable local files without an additional confirmation dialog. Use it only with models, MCP servers, and projects you trust.

License

MIT