How do I use mcp-oda?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-oda Add two liters of whole milk and a dozen eggs to my cart" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

mcp-oda by gbbirkisson

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

"Buy Me A Coffee"

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

The easiest way to use mcp-oda is with uvx:

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

Usage

Initial Setup

First, you need to authenticate with your Oda account:

# 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

NOTE

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

Configuration

Claude Desktop

Claude Desktop configuration example:

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

Claude Code

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

Troubleshooting

Session not persisting

If your login session is not persisting between runs:

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

Browser issues

If you encounter browser-related issues:

# 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