Command Palette

Search for a command to run...

Claude Skill

Install the Xobni Agent Skill to give Claude email capabilities in Claude.ai, Claude Code, and the Agent SDK.

Download & Install

Download the skill zip and install it in your preferred environment. The skill bundles the full API reference so Claude knows how to call Xobni endpoints.

Download xobni.zip

Claude.ai

Go to Settings → Features and upload the zip file. Requires Pro, Max, Team, or Enterprise plan with code execution enabled.

Claude Code

Unzip into your project or personal skills directory:

Shell
# Project-level (for one project)
unzip xobni.zip -d .claude/skills/

# Personal (available everywhere)
unzip xobni.zip -d ~/.claude/skills/

Agent SDK

Unzip into .claude/skills/ in your project and include "Skill" in your allowed_tools configuration.

What's Inside

The skill zip contains:

  • xobni/SKILL.md — Quick-start guide, MCP connection config, curl examples, and a full MCP tools reference table
  • xobni/references/api.md — Complete REST API endpoint documentation

Claude loads the SKILL.md metadata at startup and reads the full instructions on demand — so the skill consumes minimal context until needed.

Configuration

Create an API key at Settings → API Keys scoped to the agent you want Claude to use. Then configure the XOBNI_KEY environment variable so the skill can authenticate.

Claude Code

Add the key to your Claude Code settings. You can set it at the user level (applies to all projects) or project level:

~/.claude/settings.json (user-level)
{
  "env": {
    "XOBNI_KEY": "YOUR_API_KEY"
  }
}
.claude/settings.local.json (project-level, gitignored)
{
  "env": {
    "XOBNI_KEY": "YOUR_API_KEY"
  }
}

Restart Claude Code after changing settings for the env var to take effect.

Claude.ai

When prompted by the skill, provide your API key directly in the conversation. Claude.ai does not support persistent environment variables.

Agent SDK

Set the environment variable before running your agent:

Shell
export XOBNI_KEY="YOUR_API_KEY"

The skill uses this key for both REST API calls and MCP connections. All endpoints auto-resolve the agent from the key scope.

Capabilities

Send & Receive

Full email with attachments (base64, max 10 files / 10 MB)

Semantic Search

Natural language queries across email bodies and document attachments

14 MCP Tools

Inbox, threads, attachments, search, webhooks — all via MCP

Webhooks

Real-time email.received / email.sent events with HMAC verification

ExamplesTrusted Senders