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
-
Install Plannotator. It adds the hook and the commands.
curl -fsSL https://plannotator.ai/install.sh | bashYou should see
Added plannotator hook toyour Gemini settings. -
Open the Inbox. It connects the agents it finds on this computer.
plannotator inboxYou should see The terminal says
Connected Gemini CLI … to the Inbox. -
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 inboxsays Gemini CLI has nogemini 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 runplannotator inboxagain.
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
/planand review the plan in Plannotator.