Pidgeon for JavaScript and TypeScript
Email inboxes for AI agents. Pidgeon is the email inbox API for AI agents. It gives agents their own inboxes so they can work with emails just like a human.
에이전트 강화
게시자의 자체 명령입니다. PlugMCP 엔드포인트가 아닙니다.
Host a copy with our keys and logs.
npx -y @pidgeon-ai/[email protected]Claude Code에는 로컬 명령용 설치 링크가 없습니다. 아래 명령을 복사해 터미널에서 실행합니다.
claude mcp add pidgeon-ai-sdk -- npx -y @pidgeon-ai/sdk@2.2.0터미널에서 실행합니다.
{ "mcpServers": { "pidgeon-ai-sdk": { "command": "npx", "args": [ "-y", "@pidgeon-ai/[email protected]" ] } }}claude_desktop_config.json
원격 URL인가요, 내 컴퓨터에서 실행하는 명령인가요? 두 설치 방식의 차이
PlugMCP에서 실행
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
실행게시자 제공
Email inboxes for AI agents. Pidgeon is the email inbox API for AI agents. It gives agents their own inboxes so they can work with emails just like a human.
Pidgeon's TypeScript SDK: Passport, Bouncer, Email and Auth. Sign your agents' requests, verify agents at your site, send mail from agent inboxes, and Sign in with Pidgeon.
npm install @pidgeon-ai/sdk
Create an address, send from it, wait for the answer, and reply in the thread:
import {
client,
identitiesCreate,
messagesAwait,
messagesReply,
messagesSend,
} from '@pidgeon-ai/sdk';
client.setConfig({ auth: () => process.env.PIDGEON_API_KEY! });
// 1. An address of its own. Any free name on pidgeon.email works with no DNS.
const { data: address } = await identitiesCreate({
body: { address: '[email protected]', type: 'agent' },
throwOnError: true,
});
// 2. Send from it.
await messagesSend({
body: {
from: address.data.email,
to: '[email protected]',
subject: 'Staging access',
text: 'Could you send me the access code?',
},
throwOnError: true,
});
// 3. Receive: one held-open request until the answer arrives, up to 60 seconds.
const { data: awaited } = await messagesAwait({
query: { identity_id: address.data.id, timeout: 60 },
throwOnError: true,
});
// 4. Reply into the same conversation. Recipients and subject come off the original.
if (awaited.data.message) {
console.log(awaited.data.message.extracted.codes);
await messagesReply({
path: { id: awaited.data.message.id },
body: { text: 'Thanks, that worked.' },
throwOnError: true,
});
}
PIDGEON_API_KEY is a pgn_live_… key. Make one at
pidgeon.ai/app/developers/keys, or let
your agent sign itself up: pidgeon.ai/skill.md.
examples/openai-agents is an OpenAI Agents SDK
agent on the hosted server, examples/claude-agent-sdk
a Claude Agent SDK one, and examples/mastra a Mastra one. None
needs a package of ours. examples/ai-sdk is a Vercel AI SDK
agent on @pidgeon-ai/ai-sdk, asking before it replies.
activepieces/pidgeon is the Activepieces piece,
@pidgeon-ai/piece-pidgeon, in the layout Activepieces' own repository
uses (setup).
An MCP client needs no package at all. Point it at
https://pidgeon.ai/api/mcp and it signs you in with OAuth:
claude mcp add --transport http pidgeon https://pidgeon.ai/api/mcp
The plugin for Claude Code, Codex, Cursor and Gemini CLI is pidgeon-ai/pidgeon-plugins.
The SDK and the CLI are generated from openapi.json, which
is the contract the API validates against and is published at
https://pidgeon.ai/openapi.json. The application that serves it is closed
source; these clients are not, and this is where they are readable. This
repository is copied from that one on every release.
So a pull request against generated code cannot be merged as written — the fix belongs in the schema it came from. Open an issue instead and say what is wrong; that is the faster route either way, because a wrong field here is a wrong field in the published contract and in the Python client too.
Issues and questions: open one, or email [email protected].
MIT licensed.
Pidgeon's TypeScript SDK: Passport, Bouncer, Email and Auth. Sign your agents' requests, verify agents at your site, send mail from agent inboxes, and Sign in with Pidgeon.
{ "mcpServers": { "pidgeon-ai-sdk": { "command": "npx", "args": [ "-y", "@pidgeon-ai/[email protected]" ] } }}도구
아직 도구 목록이 없습니다. 원격 서버는 첫 상태 확인 후에 도구 목록이 생깁니다.
FAQ
이 페이지에서 Cursor, Claude Desktop, Claude Code 또는 VS Code용 stdio 설정을 복사합니다. PlugMCP 프록시가 아니라 게시자의 설치 방식을 사용합니다.
이 레코드에는 필수 환경 변수가 등록되어 있지 않습니다.
@pidgeon Ai/sdk은(는) stdio를 통해 로컬에서 실행됩니다.
마지막 확인: 2026-11-15. Pidgeon's TypeScript SDK: Passport, Bouncer, Email and Auth. Sign your agents' requests, verify agents at your site, send mail from agent inboxes, and Sign in with Pidgeon.