Home/Tools/@tpmjs/tools-agentmail

deleteInbox

@tpmjs/tools-agentmail

Delete an email inbox and all its messages permanently.

Official
ops
v0.1.0
MIT

Interactive Playground

Test @tpmjs/tools-agentmail (deleteInbox) with AI-powered execution

0/2000 characters

Installation & Usage

Install this tool and use it with the AI SDK

1. Install the package

npm install @tpmjs/tools-agentmail
pnpm add @tpmjs/tools-agentmail
yarn add @tpmjs/tools-agentmail
bun add @tpmjs/tools-agentmail
deno add npm:@tpmjs/tools-agentmail

2. Import the tool

import { deleteInbox } from '@tpmjs/tools-agentmail';

3. Use with AI SDK

import { generateText } from 'ai';
import { openai } from '@ai-sdk/openai';
import { deleteInbox } from '@tpmjs/tools-agentmail';

const result = await generateText({
  model: openai('gpt-4o'),
  tools: { deleteInbox },
  prompt: 'Your prompt here...',
});

console.log(result.text);

Signature

(inbox_id: string) => Promise<unknown>

Tags

agentmail
ai
delete
email
inbox
messages
ops
permanently
tpmjs

Parameters

Available configuration options

Auto-extracted
inbox_id
Required
Type: string

The inbox ID to delete.

Schema extracted: 3/1/2026, 4:28:42 AM

README

@tpmjs/tools-agentmail

AgentMail API tools for AI agents — create inboxes, send/receive emails, manage threads, drafts, and more.

Installation

npm install @tpmjs/tools-agentmail

Setup

Set the AGENTMAIL_API_KEY environment variable. Get your API key from AgentMail Dashboard.

export AGENTMAIL_API_KEY=your_api_key_here

Usage

import { createInbox, sendMessage, listMessages } from '@tpmjs/tools-agentmail';

// Create a new inbox for your AI agent
const inbox = await createInbox.execute({
  username: 'my-agent',
  display_name: 'My AI Agent',
});

// Send an email
const message = await sendMessage.execute({
  inbox_id: inbox.inbox_id,
  to: 'recipient@example.com',
  subject: 'Hello from AI',
  text: 'This is an automated message from my AI agent.',
});

// List received messages
const messages = await listMessages.execute({
  inbox_id: inbox.inbox_id,
  limit: 20,
});

Tools

ToolDescription
createInboxCreate a new email inbox with optional custom username and domain
listInboxesList all email inboxes with pagination support
getInboxGet details of a specific inbox by ID
deleteInboxDelete an inbox and all its messages permanently
sendMessageSend an email message with subject and body
replyToMessageReply to an existing email in a thread
listMessagesList email messages in an inbox with pagination
getMessageGet full details of a specific message
listThreadsList email threads, optionally filtered by labels
getThreadGet a thread with all its messages
createDraftCreate an email draft for approval before sending
sendDraftSend a previously created draft

Features

  • Complete Email Management: Create inboxes, send/receive emails, manage threads
  • Thread Support: View full conversation history with thread IDs
  • Draft Support: Create drafts for human-in-the-loop approval workflows
  • Label Support: Organize messages with custom labels
  • Pagination: Efficiently handle large inboxes with cursor-based pagination
  • Type-Safe: Full TypeScript types for all API responses

API Documentation

For detailed API documentation, visit AgentMail API Docs.

License

MIT

Statistics

Downloads/month

97

GitHub Stars

15

Quality Score

87%

Bundle Size

NPM Keywords

tpmjs
ops
ai
email
agentmail

Maintainers

thomasdavis(thomasalwyndavis@gmail.com)

Frameworks

vercel-ai