setup-inboxapi

Setup InboxAPI

Configure InboxAPI email tools for this project. Supports Claude Code, Codex CLI, Gemini CLI, and OpenCode.

Steps

1. Check current setup: Look for existing .mcp.json and .claude/settings.json files

2. Add MCP server (if not already configured):

   • Check if .mcp.json exists and contains an inboxapi entry
   • If not, run: claude mcp add inboxapi -- npx -y @inboxapi/cli
   • Or create/update .mcp.json with:

     {
       "mcpServers": {
         "inboxapi": {
           "command": "npx",
           "args": ["-y", "@inboxapi/cli"]
         }
       }
     }
     

   For other agents:

   • Codex CLI: codex mcp add inboxapi -- npx -y @inboxapi/cli
   • Gemini CLI: Add to settings.json under mcpServers:

     { "mcpServers": { "inboxapi": { "command": "npx", "args": ["-y", "@inboxapi/cli"] } } }
     

   • OpenCode: Add to opencode.json under mcp:

     { "mcp": { "inboxapi": { "command": "npx", "args": ["-y", "@inboxapi/cli"] } } }
     

3. Install skills: Run npx -y @inboxapi/cli setup-skills to install skills for detected agents

   • Use --all to install for all agents, or --claude, --codex, --gemini, --opencode for specific ones

4. Verify credentials:

   • Run: npx -y @inboxapi/cli whoami to check if credentials are set up
   • If not authenticated, instruct the user: "Run npx -y @inboxapi/cli login in a terminal to authenticate"

5. Show summary:

   InboxAPI Setup Complete!
   
   MCP Server: configured in .mcp.json
   Email: <email> (or "not authenticated yet")
   
   Installed Skills:
     /check-inbox          — View inbox summary
     /check-sent           — View sent email history
     /compose              — Write and send emails
     /download-attachment  — Download email attachments
     /email-search         — Search emails
     /email-reply          — Reply with thread context
     /email-digest         — Email activity digest
     /email-forward        — Forward emails
   
   Installed Hooks (Claude Code only):
     PreToolUse  — Email send guard (reviews before sending)
     PostToolUse — Activity logger (audit trail)
     SessionStart — Credential check (verifies auth on startup)
   
   Next steps:
     - Run /check-inbox to see your emails
     - Run /compose to send your first email