Claude Skill

Install the Xobni Agent Skill to give Claude email, calendar, storage, and search 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.

Claude Code Plugin

The Xobni Claude Code Plugin provides 4 skills, 2 commands, and an inbox-manager agent. Install from a marketplace:

Claude Code

/plugin marketplace add ghoshsanjoy78/xobni-claude-plugin
/plugin install xobni@xobni-marketplace

The plugin auto-configures the MCP server connection using your XOBNI_KEY environment variable. Skills include /xobni:email, /xobni:calendar, /xobni:storage, and /xobni:webhooks.

Capabilities

Send & Receive

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

Semantic Search

Natural language queries across email bodies and document attachments

34 MCP Tools

Email, calendar, storage, search, webhooks, and more — all via MCP

Webhooks

6 event types with HMAC-SHA256 verification

Examples Trusted Senders