Skip to main content
TypeScript · API v1 + v2 · MCP · CLI

The Plane API, typed end to end

A TypeScript SDK for the Plane API, with an MCP server and a CLI built on top of it. Use it from code, from an AI agent or from your terminal: all three share the same client.

$ npm install @hoyasumii/plane
@hoyasumii/plane

SDK

A typed client for API v1 and the whole v2 surface: 90 resources, field lists that narrow the return type at compile time, and fetched rows you can navigate to their children.

const eng = await client.v2.workspaces.projects.retrieve("acme", "ENG");
await eng.workItems.create({ name: "Fix login bug", state: "Todo" });
plane-mcp

MCP server

Plane for Claude Code, Codex, OpenCode or any MCP client: task tools that work by key and by name, plus three generic tools that reach every v2 method.

npx plane mcp config
npx plane mcp install
plane

CLI

Every MCP tool as a terminal command, plus plane mcp to run the server in the background, start it at login and register it in your clients.

npx plane get-issue --key ACME-14
npx plane list-my-issues --project ACME