Connect bundlist to Gemini CLI

Add bundlist as an MCP server in your Gemini CLI settings

Gemini CLI supports MCP servers via its settings file. Once added, every Gemini CLI session has access to your bundlist tools — create lists, add items, query your data, or capture notes as you work.

Before you start

Gemini CLI installed — get it here
A bundlist account — create one free

Setup

Open your Gemini CLI settings file
The settings file lives at ~/.gemini/settings.json. Create it if it doesn't exist:
```
mkdir -p ~/.gemini && touch ~/.gemini/settings.json
```
Add bundlist under mcpServers
Edit ~/.gemini/settings.json and add the bundlist entry. If the file is empty, use this as your starting point:
```
{
  "mcpServers": {
    "bundlist": {
      "url": "https://api.bundlist.app/mcp",
      "type": "http"
    }
  }
}
```
If the file already has other content, add the mcpServers key alongside your existing keys, or add bundlist as another entry inside an existing mcpServers block.
Start a Gemini CLI session
Run gemini in your terminal. On first use with bundlist, Gemini CLI will open a browser window to complete OAuth sign-in.
Authenticate with bundlist
Sign in with the same Google, Apple, or Facebook account you use for bundlist. Your token is stored and reused automatically.

Verify the connection

In a Gemini CLI session, ask:

Show me all my bundlist lists

Gemini should call list_lists and return your lists by name.

What to try next

See the uses guide for workflow ideas organized by list type, or the MCP overview for the full list of available tools.

Troubleshooting

Server not connecting — confirm the JSON in ~/.gemini/settings.json is valid. A trailing comma or missing quote will cause a silent failure.
Tool calls return 401 — your token has expired. Remove the bundlist entry from settings.json, restart Gemini CLI, then re-add it to trigger a fresh sign-in.

Need help?

Email support@bundlist.app with your Gemini CLI version and a description of where you're stuck.