Xobni Email

Xobni.ai Email Skill

Give AI agents real email addresses with full inbox functionality.

Quick Start

1. Create agent at xobni.ai/agents/new → gets email like your-agent@xobni.ai 2. Create API key at xobni.ai/settings/api-keys scoped to your agent 3. Connect via REST API or MCP

API Key Scoping

Each API key is scoped to a single agent. The key can only access that agent's emails, threads, attachments, and webhooks. No need to pass account_id or agent_id — they're auto-resolved from your key.

What scoped keys can do:

What scoped keys cannot do:

MCP Connection

URL: https://api.xobni.ai/mcp/ Transport: Streamable HTTP Auth: Authorization: Bearer YOUR_API_KEY

Claude Desktop Config

{
  "mcpServers": {
    "xobni": {
      "url": "https://api.xobni.ai/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Core Operations

Read Inbox

curl -H "Authorization: Bearer $XOBNI_KEY" \
  "https://api.xobni.ai/api/v1/emails?status=received&limit=20"

Send Email

curl -X POST -H "Authorization: Bearer $XOBNI_KEY" \
  -H "Content-Type: application/json" \
  "https://api.xobni.ai/api/v1/emails/send" \
  -d '{"to":["recipient@example.com"],"subject":"Hello","body_text":"Message here"}'

Send with Attachments

curl -X POST -H "Authorization: Bearer $XOBNI_KEY" \
  -H "Content-Type: application/json" \
  "https://api.xobni.ai/api/v1/emails/send" \
  -d '{
    "to":["recipient@example.com"],
    "subject":"Report",
    "body_text":"See attached.",
    "attachments":[{"filename":"report.pdf","data":"","content_type":"application/pdf"}]
  }'

Search (Semantic)

curl -X POST -H "Authorization: Bearer $XOBNI_KEY" \
  -H "Content-Type: application/json" \
  "https://api.xobni.ai/api/v1/search" \
  -d '{"query":"invoices from last month","limit":10}'

Get Agent Info

curl -H "Authorization: Bearer $XOBNI_KEY" \
  "https://api.xobni.ai/api/v1/agents"

Check Storage Usage

curl -H "Authorization: Bearer $XOBNI_KEY" \
  "https://api.xobni.ai/api/v1/emails/storage-usage"

MCP Tools (14 total)

| Tool | Purpose | |------|---------| | get_agent_info | Get agent's name, email, slug, status | | read_inbox | List emails with filters (status, limit, offset) | | read_email | Get full email content by ID | | send_email | Send with optional attachments and reply threading | | get_thread | Get all emails in a conversation | | list_attachments | List attachments for an email | | download_attachment | Get pre-signed download URL (15 min) | | get_attachment_text | Extract text from PDF/DOCX/XLSX/PPTX | | mark_email | Update status: read/unread/starred/unstarred/archived | | search_emails | Semantic search across emails + attachments | | list_webhooks | List configured webhooks | | create_webhook | Create webhook for email.received/email.sent | | delete_webhook | Remove a webhook | | list_webhook_deliveries | View webhook delivery history |

Webhooks

Set up real-time notifications when emails arrive or are sent:

curl -X POST -H "Authorization: Bearer $XOBNI_KEY" \
  -H "Content-Type: application/json" \
  "https://api.xobni.ai/api/v1/event-hooks" \
  -d '{
    "url": "https://your-endpoint.com/webhook",
    "events": ["email.received"],
    "description": "Email notifications"
  }'

Supported events: email.received, email.sent. Payloads include email metadata and a 200-character snippet. Use read_email to fetch full content.

API Reference

See references/api.md for full endpoint documentation.

Key Concepts

1. Create agent at xobni.ai/agents/new → gets email like your-agent@xobni.ai 2. Create API key at xobni.ai/settings/api-keys scoped to your agent 3. Connect via REST API or MCP