mcp-oda

If this project is just what you needed and/or has been helpful to you, please consider buying me a coffee ☕

• Features

• Installation

• Usage

  • Initial Setup

  • Configuration

    • Claude Desktop

    • Gemini CLI

• Troubleshooting

  • Session not persisting

  • Browser issues

Features

This MCP server provides tools to programmatically interact with Oda's grocery shopping platform:

• Search products - Search for groceries with support for Norwegian terms

• Browse search results - Navigate through paginated search results

• Manage shopping cart - View cart contents, add items, and remove items

• Session persistence - Maintains login session across restarts

Installation

This project requires Node.js (v18+).

npx playwright install chromium

Usage

Initial Setup

First, you need to authenticate with your Oda account using the auth subcommand:

# Open browser for authentication
npx github:gbbirkisson/mcp-oda auth

# The browser will open - log in to your Oda account
# Close the browser when done

Alternatively, you can provide your credentials for automated login:

npx github:gbbirkisson/mcp-oda auth --user your@email.com --pass yourpassword

You can verify your login status using the user command:

npx github:gbbirkisson/mcp-oda user

Configuration

Claude Desktop

Claude Desktop configuration example:

{
  "mcpServers": {
    "oda": {
      "command": "npx",
      "args": ["-y", "github:gbbirkisson/mcp-oda"]
    }
  }
}

Claude Code │

/plugin marketplace add gbbirkisson/mcp-oda                                          │
/plugin install mcp-oda@mcp-oda                                                      │

Gemini CLI

gemini extensions install https://github.com/gbbirkisson/mcp-oda

Troubleshooting

Session not persisting

If your login session is not persisting between runs:

1. Try running with the clean subcommand to remove old session data:

   npx github:gbbirkisson/mcp-oda clean

2. Re-authenticate with auth:

   npx github:gbbirkisson/mcp-oda auth

3. Make sure you're using the same --data-dir for all commands if you've overridden the default.

Browser issues

If you encounter browser-related issues, use the clean command and re-install playwright binaries:

# Clean browser data
npx github:gbbirkisson/mcp-oda clean

# Re-install browser
npx playwright install chromium

# Re-authenticate
npx github:gbbirkisson/mcp-oda auth