MCP

MCP (Model Context Protocol) connects Mottainai to external AI assistants. This is a key part of Mottainai's broader anti-waste direction: spend less time on repetitive input and more time on outcomes.

Examples:

• "What expires this week?"
• "Add oat milk to my shopping list."
• "Create a board for weekly planning."
• "Summarize what I should do first to avoid waste this week."
• "Create a weekly meal plan for 2 people with lunch — healthy and low-calorie."
• "Add fitting images to my recipes."
• [Photo of a food item] "Add this to my storage."
• [Photo of an invitation or event] "Add this to my calendar."

Explicit phrasing isn't required — Mottainai understands short inputs too:

• [Photo of an empty package] "gone" — reduces the quantity in storage by 1
• [Photo of a food item] — adds it directly to storage
• "wc done" — moves "Clean bathroom" on the board from "To do" to "Done"

Setup

Simple — Claude (Web)

Claude is recommended — it's the easiest to set up. No token required.

1. Open claude.ai/settings/connectors.
2. Click Add connector.
3. Enter Mottainai as the name.
4. Enter https://mottainai.app/mcp as the Remote MCP Server URL.
5. Click Add and authorize Mottainai via OAuth.

Advanced — with API token

For terminal clients and other AI tools. You need an API token:

1. Open Settings → API Tokens in Mottainai.
2. Create a token (for example MCP) and copy it immediately. It is shown only once.

Note: Replace mot_YOUR_TOKEN in the examples below with your real token.

Client configuration

If you used the simple Claude Web setup above, you're already connected — no further configuration needed. The configs below apply when using an API token.

Cursor (`~/.cursor/mcp.json`)

{
  "mcpServers": {
    "mottainai": {
      "url": "https://mottainai.app/mcp",
      "headers": {
        "Authorization": "Bearer mot_YOUR_TOKEN"
      }
    }
  }
}

Claude Code (Terminal)

claude mcp add --transport http mottainai \
  https://mottainai.app/mcp \
  --header "Authorization: Bearer mot_YOUR_TOKEN"

Claude Desktop (`claude_desktop_config.json`)

{
  "mcpServers": {
    "mottainai": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "--header",
        "Authorization: Bearer mot_YOUR_TOKEN",
        "https://mottainai.app/mcp"
      ]
    }
  }
}

Codex (Terminal)

export MOTTAINAI_MCP_TOKEN="mot_YOUR_TOKEN"

codex mcp add mottainai \
  --url https://mottainai.app/mcp \
  --bearer-token-env-var MOTTAINAI_MCP_TOKEN

Gemini (Terminal)

gemini mcp add mottainai --transport http \
  https://mottainai.app/mcp \
  --header "Authorization: Bearer mot_YOUR_TOKEN"

---

Mottainai aims to get out of the way as much as possible. The goal: reduce manual steps to the absolute minimum — while always keeping a full picture of what you have.