Connect bundlist to Claude Code

Add bundlist as an MCP server in your Claude Code configuration

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

Before you start

• Claude Code installed — get it here
• A bundlist account — create one free

Option 1 — CLI (recommended)

Run this command in your terminal:

claude mcp add --transport http bundlist https://api.bundlist.app/mcp

Claude Code adds bundlist to ~/.claude.json and will prompt you to authenticate on next session start.

Option 2 — Manual config

Open (or create) ~/.claude.json and add bundlist under the mcpServers key:

{
  "mcpServers": {
    "bundlist": {
      "transport": "http",
      "url": "https://api.bundlist.app/mcp"
    }
  }
}

If the file already has other servers, add bundlist as another entry inside mcpServers.

Authenticate

Start a new Claude Code session. On first use, Claude Code opens a browser window for OAuth. Sign in with the same Google, Apple, or Facebook account you use for bundlist. Your token is stored and reused automatically across sessions.

If the browser prompt doesn't appear automatically, run /mcp in Claude Code and select bundlist to trigger authentication manually.

Verify the connection

In a Claude Code session, ask:

List my bundlist lists

Claude should call list_lists and return your lists.

Project-scoped config

If you only want bundlist available in a specific project, add a .mcp.json file in the project root:

{
  "mcpServers": {
    "bundlist": {
      "transport": "http",
      "url": "https://api.bundlist.app/mcp"
    }
  }
}

Project-scoped config takes precedence over the global config for that directory.

What to try next

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

Troubleshooting

• Server not appearing — run claude mcp list to confirm bundlist is registered. If it's missing, re-run the add command.
• Authentication loop — run claude mcp remove bundlist, then re-add it to start a fresh OAuth flow.
• Tool calls return 401 — your token has expired. Run /mcp in Claude Code and choose to reauthenticate bundlist — no need to remove and re-add the server.

Need help?

Email support@bundlist.app with your Claude Code version (claude --version) and a description of where you're stuck.