Skip to navigation
Integrations

Skills

Add PostNuvia to AI coding assistants with the official skill

Getting started

PostNuvia provides an official skill that can be installed on AI coding assistants and agents that support the AgentSkills format. This includes OpenClaw, Claude Code, Cursor, Codex, and other compatible tools.

The skill is available at skills.sh/postnuvia-to/postnuvia-skills/postnuvia.

Installation

Install the skill using the skills CLI. This works with Claude Code, Cursor, OpenClaw, Codex, and other compatible agents:

npx skills add postnuvia-to/postnuvia-skills

To skip interactive prompts, specify the skill and agent directly:

npx skills add postnuvia-to/postnuvia-skills --skill postnuvia --agent claude-code

Plugins for Claude Code, Cursor, and Codex

The PostNuvia plugin bundles these skills with the hosted MCP server, so the assistant can act on your inboxes and sign them in to apps with AgentID. It signs in with OAuth on first use; no API key is needed.

Claude Code
/plugin marketplace add postnuvia-to/postnuvia-plugins
/plugin install postnuvia@postnuvia
Cursor
/add-plugin postnuvia
Codex
codex plugin marketplace add postnuvia-to/postnuvia-plugins
codex plugin add postnuvia@postnuvia

Start a new session after installing. Plugin skills are namespaced in Claude Code, for example /postnuvia:check-email, and use a $ prefix in Codex, for example $check-email.

OpenClaw

OpenClaw users should install the official plugin instead, which bundles this skill along with the email channel. See OpenClaw.

openclaw plugins install clawhub:@postnuvia/postnuvia

Manual installation

You can also manually clone the skill repository:

git clone https://github.com/postnuvia-to/postnuvia-skills.git ~/.skills/postnuvia

Configuration

After installation, configure your PostNuvia API key. The method varies by platform:

Environment variable

Set the POSTNUVIA_API_KEY environment variable:

export POSTNUVIA_API_KEY="your-api-key-here"

OpenClaw configuration

Add the API key to ~/.openclaw/openclaw.json:

{
  "skills": {
    "entries": {
      "postnuvia": {
        "enabled": true,
        "env": {
          "POSTNUVIA_API_KEY": "your-api-key-here"
        }
      }
    }
  }
}

Get your API key from the PostNuvia Console.

Features

The official PostNuvia skill provides comprehensive email functionality:

Inboxes

Create scalable inboxes on-demand. Each inbox has a unique email address that your AI agent can use to send and receive emails.

Messages

Send emails with both plain text and HTML content for best deliverability. The skill handles proper formatting and headers automatically.

Threads

Threads group related messages in a conversation, making it easy to follow email chains and maintain context across multiple exchanges.

Attachments

Send and receive attachments with Base64 encoding. The skill can retrieve attachments from messages or threads.

Drafts

Create drafts for human-in-the-loop approval before sending. This is useful when you want to review emails before they go out.

Pods

Multi-tenant isolation for SaaS platforms. Each customer gets isolated inboxes, perfect for building email-enabled applications.

Idempotency

Use idempotency keys for safe retries on create operations. This prevents duplicate emails when network errors occur.

AgentID accounts

Create accounts for your agent at services like Firecrawl with AgentID, using an inbox as its identity, and see where it already has accounts. The AgentID skill (postnuvia-agentid from skills.sh, agentid in the plugin) carries the whole job: finding the app, picking the inbox, the sign-in link, and storing the API key you came for.

Real-time events

The skill supports both WebSockets (persistent connection, no public URL needed) and webhooks (HTTP-based notifications) for real-time email notifications.

Example usage

Once installed, you can ask your AI assistant to perform email tasks:

  • “Create a new email inbox for my project”
  • “Send an email to john@example.com about the meeting tomorrow”
  • “Check my inbox for new emails”
  • “Reply to the latest email from Sarah”
  • “Create a draft response to the support ticket”
  • “Create an account at Firecrawl for my agent”
  • “My agent needs a web search API, set one up”

Resources