Skip to main content
Glama
Sign In
mcp-oda

mcp-oda

by gbbirkisson
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local
CAUTION

This project is deprecated.

Oda now provides an official MCP server. Use it instead:

👉 oda.com/mcp

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 recipes - Search, filter, and view recipe details

  • Saved shopping lists - View your saved lists, add or remove products, and import a whole list into the cart

  • Purchase history - See your most frequently ordered products

  • Manage shopping cart - View cart contents and recommendations, add/remove items or set exact quantities, add recipe ingredients

  • Delivery slots - See upcoming delivery slots, prices and ordering deadlines (read-only)

  • CLI access - All operations available as CLI subcommands in addition to MCP tools

  • Session persistence - Maintains login session across restarts

Related MCP server: Willys MCP Server

Installation

This project requires Node.js (v18+).

Usage

Initial Setup

Authenticate with your Oda account:

read -rsp "Oda password: " ODA_PASSWORD
printf '\n'
printf '%s' "$ODA_PASSWORD" | npx github:gbbirkisson/mcp-oda auth login --user your@email.com --pass-stdin
unset ODA_PASSWORD

Verify your login status:

npx github:gbbirkisson/mcp-oda auth user
NOTE

Session data is stored by default in~/.mcp-oda

CLI Commands

Running npx github:gbbirkisson/mcp-oda with no arguments prints help. The mcp subcommand starts the MCP server. All other operations are available as subcommands:

# Start the MCP server
npx github:gbbirkisson/mcp-oda mcp

# Products
npx github:gbbirkisson/mcp-oda product search melk
npx github:gbbirkisson/mcp-oda product search melk --page 2
npx github:gbbirkisson/mcp-oda product add 132

# Saved shopping lists
npx github:gbbirkisson/mcp-oda saved-list list
npx github:gbbirkisson/mcp-oda saved-list details 123
# Adds a product to a saved list; requires an explicit confirmation string
npx github:gbbirkisson/mcp-oda saved-list add-product 123 456 --confirmation "UPDATE SAVED LIST"
# Removes a product from a saved list; requires an explicit confirmation string
npx github:gbbirkisson/mcp-oda saved-list remove-product 123 456 --confirmation "UPDATE SAVED LIST"
# Adds every list item to the cart; requires an explicit confirmation string
npx github:gbbirkisson/mcp-oda saved-list add 123 --confirmation "ADD SAVED LIST TO CART"

# Purchase history
npx github:gbbirkisson/mcp-oda purchases frequent
npx github:gbbirkisson/mcp-oda purchases frequent --limit 10 --max-orders 50

# Cart
npx github:gbbirkisson/mcp-oda cart list
npx github:gbbirkisson/mcp-oda cart recommendations --limit 10 --exclude-in-cart
npx github:gbbirkisson/mcp-oda cart remove 132
# Sets the total quantity of a product; 0 removes it
npx github:gbbirkisson/mcp-oda cart set 132 --count 3
# Clears the whole cart; requires an explicit confirmation string
npx github:gbbirkisson/mcp-oda cart clear --confirmation "CLEAR CART"

# Recipes
npx github:gbbirkisson/mcp-oda recipe search pizza
npx github:gbbirkisson/mcp-oda recipe details 123
npx github:gbbirkisson/mcp-oda recipe add 123 --portions 4
npx github:gbbirkisson/mcp-oda recipe remove 123

# Delivery slots and ordering deadlines (read-only)
npx github:gbbirkisson/mcp-oda delivery slots

# Authentication
read -rsp "Oda password: " ODA_PASSWORD
printf '\n'
printf '%s' "$ODA_PASSWORD" | npx github:gbbirkisson/mcp-oda auth login --user your@email.com --pass-stdin
unset ODA_PASSWORD
npx github:gbbirkisson/mcp-oda auth logout
npx github:gbbirkisson/mcp-oda auth user

# Maintenance
npx github:gbbirkisson/mcp-oda clean

Configuration

Claude Desktop

Claude Desktop configuration example:

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

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:

    read -rsp "Oda password: " ODA_PASSWORD
printf '\n'
printf '%s' "$ODA_PASSWORD" | npx github:gbbirkisson/mcp-oda auth login --user your@email.com --pass-stdin
unset ODA_PASSWORD

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • oda-mcp

      kolonialno
      A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables agentic grocery shopping on Oda (Norway) and Mathem (Sweden) platforms through an MCP-compatible interface. Users can search for products, manage their shopping cart, and access order history using natural language commands.
      1
      MIT

    • grocery-mcp

      JiteshPL
      A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for grocery-related web automation using Playwright, enabling AI assistants to interact with grocery websites.
      ISC

    • kundeavis-mcp

      donadelicc
      A
      license
      A
      quality
      D
      maintenance
      MCP server that queries Norwegian grocery store flyers (kundeaviser) to help AI agents plan cheap meals based on current offers.
      7
      1
      MIT

    Appeared in Searches