MCP ODA Server

Provides programmatic access to Oda's grocery features: search, browse results, and cart management via an MCP interface.

javascript

4

GitHub Stars

javascript

Language

2 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "gbbirkisson-mcp-oda": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/gbbirkisson/mcp-oda",
        "mcp-oda"
      ],
      "env": {
        "DATA_DIR": "YOUR_DATA_DIR"
      }
    }
  }
}

You can interact with Oda’s grocery shopping platform programmatically through this MCP server. It lets you search for products, browse results, manage your cart, and keep your login session active across restarts, all from your MCP client.

How to use

Connect to the MCP server from your MCP client to access Oda grocery shopping capabilities. You can search for products using Norwegian terms, navigate through search results, view and modify your shopping cart, and rely on session persistence to avoid re-authenticating after restarts.

How to install

Prerequisites you need before running the MCP server are a compatible runtime and the MCP runner you choose to use. Ensure you have a runtime capable of executing the MCP commands shown below.

Install and run the MCP server using the following commands:

# Run directly from GitHub
uvx --from git+https://github.com/gbbirkisson/mcp-oda mcp-oda --help

Configuration

Configure how you run the MCP server in your MCP client with the examples below. These show how to reference the mcp-oda server from two common client environments.

{
  "mcpServers": {
    "oda": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/gbbirkisson/mcp-oda", "mcp-oda"]
    }
  }
}

Initial Setup

You must authenticate with your Oda account to start using the MCP server. The authentication flow opens a browser for you to log in, and stores session data locally.

# Open browser for authentication
uvx --from git+https://github.com/gbbirkisson/mcp-oda mcp-oda --auth

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

# Verify you are still logged in
uvx --from git+https://github.com/gbbirkisson/mcp-oda mcp-oda --auth

Claude Desktop

Configure Claude Desktop to access the oda MCP server with the following JSON. This maps a server named oda to the MCP command invocation.

{
  "mcpServers": {
    "oda": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/gbbirkisson/mcp-oda", "mcp-oda"]
    }
  }
}

Claude Code

Add the Oda MCP server integration to Claude Code with a single command.

claude mcp add oda -s user -- uvx --from git+https://github.com/gbbirkisson/mcp-oda mcp-oda

Troubleshooting

If you encounter issues with session persistence or browser behavior, follow these steps to recover a stable setup.

Session not persisting: If your login session is not persisting between runs, try the following steps.

1) Try running with `--clean` to remove old session data
2) Re-authenticate with `--auth`
3) Make sure you're using the same `--data-dir` for both auth and normal runs

Browser issues

If you experience browser-related issues during authentication, reset browser data and re-authenticate.

# Clean browser data
uvx --from git+https://github.com/gbbirkisson/mcp-oda mcp-oda --clean

# Re-authenticate
uvx --from git+https://github.com/gbbirkisson/mcp-oda mcp-oda --auth

Available tools

Search products

Query the Oda catalog with search terms, including support for Norwegian terms.

Browse search results

Navigate through paginated results to refine or expand your view.

Manage shopping cart

View cart contents, add items, and remove items from your cart.

Session persistence

Maintain login state across restarts to avoid repeated authentication.