MCP & CLI

CLI

The heydecks CLI connects Claude, Cursor, or your own agent to heydecks in one command with OAuth, no token to paste, and installs the agent skills.

heydecks CLI

The heydecks CLI is the fastest way to connect an AI host to heydecks. It configures Claude Desktop, Claude Code, or Cursor for you to sign in with OAuth (no token to paste), and installs the heydecks agent skills. It is open source (github.com/heydecks/heydecks) and on npm as heydecks.

#Quickstart

Shell

npx heydecks install

This connects every AI host you have installed (Claude Desktop, Claude Code, Cursor) and offers to add the agent skills. Restart the app; the first time it connects, a browser opens so you can sign in with OAuth, no token to paste. Then ask your assistant to "make a deck from these notes" and you get back a live link, a PDF, and a native PPTX.

Want just one host? npx heydecks install cursor. Prefer a token? Add --token mcp_xxx (get one at /dashboard/mcp).

#Install

You do not have to install anything. npx heydecks <command> always runs the latest version. To get a permanent heydecks command:

Shell

npm install -g heydecks

#Commands

Command	What it does
`heydecks install [host]`	Connect a host with OAuth, or all of them if you name none. Add `--token` for the token path.
`heydecks login`	Save your token, or set `HEYDECKS_TOKEN`.
`heydecks skills add`	Install the heydecks agent skills (`--project` for the current repo).
`heydecks mcp`	The local connector for the token path. Your host runs this; you usually will not.
`heydecks help`	Show help.

#How it connects

heydecks install points each host at the hosted server https://heydecks.com/mcp and lets it sign in with OAuth:

Cursor and Claude Code connect to the URL directly and run the browser sign-in.
Claude Desktop speaks stdio only, so it bridges through mcp-remote, which handles the sign-in.

Restart the app after installing; the first connection opens a browser to authorize heydecks. To wire a host by hand, or to use a token instead of OAuth, see the MCP server guide.

#The agent skills

Shell

npx heydecks skills add

Installs two skills into ~/.claude/skills/ (use --project for ./.claude/skills/):

heydecks teaches the build flow, choosing slide types, brand, and copy quality.
heydecks-deck-design gives slide-by-slide recipes for pitch, sales, board, launch, and QBR decks.

#Authentication

OAuth (default). npx heydecks install sets your host up to sign in to heydecks in the browser. Nothing to paste; the host (or mcp-remote) manages the token and its refresh.

Token (fallback). Prefer a static token, or running headless? Get an mcp_ token at /dashboard/mcp and pass --token, save it with heydecks login, or set HEYDECKS_TOKEN. See MCP server.

#Use it from your own code

If you are building your own product rather than using a chat host, skip the CLI and call the REST API directly. The CLI is for wiring AI assistants to heydecks.