AI代理邮件工具包

为AI代理提供完整的电子邮件基础设施,支持发送、接收、回复、搜索邮件、管理联系人等27种邮件操作。

  • by KeyID-AI
  • JavaScript
  • 本地部署
  • 660 星标
  • 更新于
在 GitHub 查看 KeyID-AI/agent-kit

使用说明

@密钥/代理工具包

给Claude、Cursor或任何MCP客户端一个真实的电子邮件地址。免费。没有注册。

通过模型上下文协议(MCP)的27个电子邮件工具:发送、接收、回复、搜索收件箱、管理联系人、设置自动回复、安排交付——人工智能代理自主处理电子邮件所需的一切。

由...驱动 KeyID.ai --为人工智能代理提供免费的电子邮件基础设施。无需人工注册,无需管理API密钥,无需任何成本。

安装

npm install @keyid/agent-kit
# or
yarn add @keyid/agent-kit

用法

使用克劳德桌面

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "keyid": {
      "command": "npx",
      "args": ["@keyid/agent-kit"],
      "env": {
        "KEYID_PUBLIC_KEY": "...hex...",
        "KEYID_PRIVATE_KEY": "...hex..."
      }
    }
  }
}

使用任何MCP客户端

# Run directly
npx @keyid/agent-kit

# Or with existing keypair
KEYID_PUBLIC_KEY=abc123 KEYID_PRIVATE_KEY=def456 npx @keyid/agent-kit

环境变量

变量 描述 默认值
KEYID_BASE_URL API基本URL https://keyid.ai
KEYID_PUBLIC_KEY Ed25519公钥(十六进制) 自动生成
KEYID_PRIVATE_KEY Ed25519私钥(十六进制) 自动生成

工具(27)

身份与认证

工具 说明
keyid_provision 注册代理,获取电子邮件地址
keyid_get_email 获取当前活动电子邮件

消息

工具 说明
keyid_get_inbox 获取收件箱(带搜索、过滤)
keyid_send 发送电子邮件(计划、显示名称、HTML)
keyid_reply 回复消息
keyid_forward 转发消息
keyid_update_message 更新已读/星号状态
keyid_get_unread_count 统计未读邮件

线程和草稿

工具 说明
keyid_list_threads 列出对话线索
keyid_get_thread 获取包含消息的线程
keyid_create_draft 创建草稿
keyid_send_draft 发送草稿

设置

工具 说明
keyid_get_auto_reply 获取自动回复设置
keyid_set_auto_reply 配置假期响应者
keyid_get_signature 获取电子邮件签名
keyid_set_signature 设置电子邮件签名
keyid_get_forwarding 获取转发设置
keyid_set_forwarding 配置转发

联系人

工具 说明
keyid_list_contacts 列出已保存的联系人
keyid_create_contact 创建联系人
keyid_delete_contact 删除联系人

网络钩子

工具 说明
keyid_list_webhooks 列出webhooks
keyid_create_webhook 创建webhook
keyid_get_webhook_deliveries 交货历史

列表和指标

工具 说明
keyid_manage_list 在允许/阻止列表中添加/删除
keyid_get_metrics 查询使用指标

对话示例

User: Check my email

Agent: [calls keyid_get_inbox]
You have 3 new messages:
1. alice@company.com — "Q1 Report" (2 hours ago)
2. bob@partner.org — "Meeting tomorrow" (5 hours ago)
3. noreply@service.com — "Password reset" (1 day ago)

User: Reply to Alice saying I'll review it today

Agent: [calls keyid_reply with message_id and body]
Reply sent to alice@company.com.

协议

通过stdio使用MCP JSON-RPC(协议版本2024-11-05)。与Claude Desktop、Cursor和任何MCP客户端兼容。

许可证

麻省理工学院