All agents

Gemini CLI

A hook opens Gemini CLI’s plans in Plannotator and it reaches the Inbox through MCP.

Hooks and MCP · Plannotator’s hooks and commands plus the Inbox through MCP

Set it up

  1. Install Plannotator. It adds the hook and the commands.

    curl -fsSL https://plannotator.ai/install.sh | bash

    You should see Added plannotator hook to your Gemini settings.

  2. Open the Inbox. It connects the agents it finds on this computer.

    plannotator inbox

    You should see The terminal says Connected Gemini CLI … to the Inbox.

  3. Start a new Gemini CLI session. Plan review needs Gemini CLI 0.36 or newer.

Other ways

Connect the Inbox yourself

This adds it in every project.

gemini mcp add -s user plannotator-inbox plannotator inbox mcp

On Windows

Install Plannotator from PowerShell. The other steps are the same.

irm https://plannotator.ai/install.ps1 | iex

Check it works

Paste this into Gemini CLI.

Send me a test question in the Plannotator Inbox, and read my answer when I tell you I sent it.

You should see A question arrives in the Inbox. Answer it and press Send. Tell Gemini CLI you sent it and it reads your answer.

Troubleshooting

The installer says to add the hook to ~/.gemini/settings.json

It couldn’t merge your settings. Add the lines it printed. The Gemini guide has them too.

plannotator inbox says Gemini CLI has no gemini mcp add

Update Gemini CLI to 0.1.19 or newer.

Your reply never shows up in the session on its own

Nothing can wake Gemini CLI: it sees a reply when it reads the thread. Tell it to check the Inbox.

The Inbox doesn’t open

Read ~/.plannotator/inbox/inbox.log. Stop a stuck Inbox process and run plannotator inbox again.

What works

  • Inbox tool MCP
  • Reply wakes it Not woken
  • Start from Inbox No
  • Permission cards No
  • Plan review Yes
  • Code review Yes
  • Annotate Files
  • Ask this session No

Examples

  • Use /plan and review the plan in Plannotator.

Every agent Full Gemini CLI guide

Built by

With contributions from