https://github.com/gbbirkisson/mcp-oda
https://github.com/gbbirkisson/mcp-oda
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/gbbirkisson/mcp-oda
- Owner: gbbirkisson
- Created: 2025-07-03T13:38:23.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-07-03T13:58:25.000Z (12 months ago)
- Last Synced: 2025-09-06T18:24:25.515Z (10 months ago)
- Language: Python
- Size: 49.8 KB
- Stars: 4
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
mcp-oda
A Model Context Protocol (MCP) server for interacting with oda.com
If this project is just what you needed and/or has been helpful to you, please consider buying
me a coffee ☕
[](https://www.buymeacoffee.com/gbbirkisson)
Table of contents
* [Features](#features)
* [Installation](#installation)
* [Usage](#usage)
* [Initial Setup](#initial-setup)
* [CLI Commands](#cli-commands)
* [Configuration](#configuration)
* [Claude Desktop](#claude-desktop)
* [Claude Code](#claude-code)
* [Gemini CLI](#gemini-cli)
* [Troubleshooting](#troubleshooting)
* [Session not persisting](#session-not-persisting)
## 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
- **Manage shopping cart** - View cart contents, add/remove items, add recipe ingredients
- **CLI access** - All operations available as CLI subcommands in addition to MCP tools
- **Session persistence** - Maintains login session across restarts
## Installation
This project requires Node.js (v18+).
## Usage
### Initial Setup
Authenticate with your Oda account:
```bash
npx github:gbbirkisson/mcp-oda auth login --user your@email.com --pass yourpassword
```
Verify your login status:
```bash
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:
```bash
# 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
# Cart
npx github:gbbirkisson/mcp-oda cart list
npx github:gbbirkisson/mcp-oda cart remove 132
npx github:gbbirkisson/mcp-oda cart clear
# 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
# Authentication
npx github:gbbirkisson/mcp-oda auth login --user your@email.com --pass yourpassword
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:
```json
{
"mcpServers": {
"oda": {
"command": "npx",
"args": ["-y", "github:gbbirkisson/mcp-oda", "mcp"]
}
}
}
```
#### Claude Code
```bash
/plugin marketplace add gbbirkisson/mcp-oda
/plugin install mcp-oda@gbbirkisson/mcp-oda
```
#### Gemini CLI
```bash
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:
```bash
npx github:gbbirkisson/mcp-oda clean
```
2. Re-authenticate:
```bash
npx github:gbbirkisson/mcp-oda auth login --user your@email.com --pass yourpassword
```
3. Make sure you're using the same `--data-dir` for all commands if you've overridden the default.