Gemini CLI - Google's AI with screen context

​

Setup

{
  "mcpServers": {
    "screenpipe": {
      "command": "npx",
      "args": ["-y", "screenpipe-mcp"]
    }
  }
}

​

Usage

gemini

> what was I working on this morning?

> find the error message I saw in my terminal earlier

> summarize the documentation I was reading about kubernetes

​

Available tools

​

Example workflows

> I was looking at a react component earlier that handled
> form validation, find it and help me implement something similar

> there was an error in my build output, find it and help me fix it

> what did that API documentation say about rate limits?

​

Requirements

• Screenpipe running on localhost:3030
• Gemini CLI installed
• Node.js >= 18.0.0

​

Troubleshooting

1. Verify Screenpipe is running:
   curl http://localhost:3030/health
   
   you should see {"status":"healthy"}. If this fails, start Screenpipe first.
2. Check the settings file path: the config should be in ~/.gemini/settings.json. Verify the file exists and contains valid JSON:
   cat ~/.gemini/settings.json | jq .
   
3. Restart Gemini CLI: after adding or modifying the config, fully restart Gemini CLI. If it was running in a terminal, exit and reopen it.

• Make sure Screenpipe has recorded data: curl "http://localhost:3030/search?limit=1"
• If empty, let Screenpipe run for a minute and try again
• Check screen recording is enabled (macOS: System Settings > Privacy & Security > Screen Recording)