Connect Claude Code to Desklet

One command, or the Desklet CLI and skill.

With one command

  1. Add Desklet in a terminal.

    claude mcp add --transport http --scope user desklet https://desklet.io/mcp
  2. In Claude Code, run /mcp, choose desklet and sign in.

    /mcp

With the Desklet CLI and skill

For Claude Code on a computer where it runs shell commands.

  1. Install the Desklet CLI with Homebrew, or with the install script where there is no Homebrew.

    brew install --cask desklet-io/tap/desklet
    curl -fsSL https://raw.githubusercontent.com/desklet-io/desklet/master/install.sh | sh
  2. Sign in once. The browser opens and asks which desks this computer sees and the mode. It shows up in Settings → Agents as Desklet CLI.

    desklet login
  3. Add the Desklet skill, which teaches Claude Code the CLI and its rules.

    npx skills add desklet-io/desklet

When you sign in

Desklet asks which desks Claude Code may see, and whether it may only read (Read) or also put results on them (Read & add). Claude Code then shows up in Settings → Agents.

Try asking

  • “Check Desklet and review the draft I put on the Work desk.”
  • “Put the result on Desklet.”

If it doesn’t work

If Claude Code shows Desklet as not signed in, run:

claude mcp login desklet

What a connected agent can do

  • It never deletes anything, whichever way it connects.
  • It sees only the desks you choose.
  • You pick the mode: Read, where it only looks, or Read & add, where it also puts results on the desk.
  • You can disconnect it any time in Settings → Agents, or revoke an AI link from the desk’s ⋯ menu.