← Back to Skills Marketplace
elie222

Inbox Zero API CLI

by Elie Steinbock · GitHub ↗ · v2.29.2 · MIT-0
cross-platform ✓ Security Clean
200
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install inbox-zero-api
Description
Use the Inbox Zero API CLI to inspect the live API schema, list and manage automation rules, and read inbox analytics through the public API. Use this when a...
README (SKILL.md)

Inbox Zero API CLI

Use this skill when the task is to inspect or change Inbox Zero state through the public API.

Workflow

  1. Prefer --json so the output is stable and machine-readable.
  2. Keep credentials in INBOX_ZERO_API_KEY or OpenClaw skill config. Avoid passing API keys as CLI flags unless there is no alternative.
  3. Before creating or replacing a rule body, fetch the live schema with inbox-zero-api openapi --json.
  4. For create and update flows, write JSON into a workspace file or pipe it on stdin.
  5. Treat rules update as a full replacement. Read the current rule first if you only intend to change part of it.

Quick Start

inbox-zero-api rules list --json
inbox-zero-api stats by-period --period week --json
inbox-zero-api openapi --json

If the CLI is not installed yet, install it with the OpenClaw installer or run npm install -g @inbox-zero/api.

OpenClaw Config

Set the API key in ~/.openclaw/openclaw.json under skills.entries.inboxZeroApi.apiKey, or export INBOX_ZERO_API_KEY in the host environment.

Use INBOX_ZERO_BASE_URL or inbox-zero-api config set base-url \x3Curl> only for self-hosted or nonstandard deployments.

Reference

For exact command patterns and a safe mutation flow, read references/cli-reference.md.

Usage Guidance
This skill appears to do what it says: a CLI front-end for the Inbox Zero API that needs a single API key. Before installing, confirm the npm package @inbox-zero/api and the homepage (https://www.getinboxzero.com) are the official sources. Installing from npm requires trust because install scripts can run arbitrary code; prefer installing in a controlled environment. Prefer providing the API key via a short-lived environment variable rather than persisting it in ~/.openclaw/openclaw.json or ~/.inbox-zero-api/config.json unless you trust the host. If you have concerns about autonomous invocation, restrict the skill's usage or avoid granting it broad implicit invocation. Rotate the API key if you later suspect it was stored or exposed improperly.
Capability Analysis
Type: OpenClaw Skill Name: inbox-zero-api Version: 2.29.2 The skill bundle provides a legitimate interface for the Inbox Zero API CLI tool (@inbox-zero/api). It facilitates managing automation rules and viewing inbox analytics through standard CLI commands as documented in SKILL.md and references/cli-reference.md. The implementation follows standard OpenClaw patterns for authentication via environment variables (INBOX_ZERO_API_KEY) and contains no evidence of data exfiltration, malicious execution, or prompt injection.
Capability Assessment
✓ Purpose & Capability
Name/description, required binary (inbox-zero-api), primary env var (INBOX_ZERO_API_KEY), and the npm install spec (@inbox-zero/api) all align with a CLI for the Inbox Zero API. No unrelated credentials or binaries are requested.
ℹ Instruction Scope
The SKILL.md stays within the CLI's scope: it instructs reading the OpenAPI schema, listing/managing rules, and using local workspace files or stdin for rule JSON. It references writing/reading configs under ~/.openclaw/openclaw.json and ~/.inbox-zero-api/config.json — expected for config storage but worth noting because those are places secrets may be persisted.
ℹ Install Mechanism
Install is via npm (@inbox-zero/api) which is an expected mechanism for a CLI provided as an npm package. This carries the usual npm risks (install scripts, supply-chain exposure). No arbitrary download URLs or archive extraction is used.
✓ Credentials
Only INBOX_ZERO_API_KEY is required (primaryEnv). An optional INBOX_ZERO_BASE_URL is documented for self-hosting. The number and nature of env vars are proportional to the stated functionality. Be aware the SKILL.md recommends storing the key in OpenClaw config or local config files, which persists the secret to disk.
✓ Persistence & Privilege
always:false and user-invocable:true are appropriate. The skill's agent policy allows implicit invocation (policy.allow_implicit_invocation: true) which is a standard setting for skills; it increases autonomy but is not unusual. The skill does not request elevated or cross-skill config changes.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install inbox-zero-api
  3. After installation, invoke the skill by name or use /inbox-zero-api
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.29.2
Initial release — manage Inbox Zero rules and stats via the public API CLI
Metadata
Slug inbox-zero-api
Version 2.29.2
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Inbox Zero API CLI?

Use the Inbox Zero API CLI to inspect the live API schema, list and manage automation rules, and read inbox analytics through the public API. Use this when a... It is an AI Agent Skill for Claude Code / OpenClaw, with 200 downloads so far.

How do I install Inbox Zero API CLI?

Run "/install inbox-zero-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Inbox Zero API CLI free?

Yes, Inbox Zero API CLI is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Inbox Zero API CLI support?

Inbox Zero API CLI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Inbox Zero API CLI?

It is built and maintained by Elie Steinbock (@elie222); the current version is v2.29.2.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments