How do I install Listonic?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Listonic need an API key?

The publisher lists these environment variables: LISTONIC_EMAIL, LISTONIC_PASSWORD, LISTONIC_LIST_ID.

What transport does Listonic use?

Listonic runs locally over stdio.

When was Listonic last checked?

Last checked 2026-11-14. Let your AI manage your real grocery list — unofficial Listonic MCP server

Listonic MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

uvx listonic-mcp==0.1.1

Credentials from the publisher

LISTONIC_EMAIL — Listonic account email
LISTONIC_PASSWORD — Listonic account password
LISTONIC_LIST_ID — Optional: pin a default list id (otherwise the account's first list is used)

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1LISTONIC_EMAIL=<value> LISTONIC_PASSWORD=<secret> LISTONIC_LIST_ID=<value> claude mcp add io.github.arturlys-listonic-mcp -- uvx listonic-mcp==0.1.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.arturlys-listonic-mcp": {4      "command": "uvx",5      "args": [6        "listonic-mcp==0.1.1"7      ],8      "env": {9        "LISTONIC_EMAIL": "<value>",10        "LISTONIC_PASSWORD": "<secret>",11        "LISTONIC_LIST_ID": "<value>"12      }13    }14  }15}

claude_desktop_config.json

Local · pypiPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.1

From the publisher

Documentation

listonic-mcp

An MCP (Model Context Protocol) server that gives AI agents — Claude, Cursor, or any MCP client — hands on your real Listonic grocery list. Read it, add to it, check things off, across every device Listonic syncs to.

Param	Env var	Default	What it does
`--email`	`LISTONIC_EMAIL`	—	Listonic account email (required).
`--password`	`LISTONIC_PASSWORD`	—	Listonic account password (required).
`--list-id`	`LISTONIC_LIST_ID`	first list	Pin a default list; see `get_lists` for the ids.

Tool	What it does
`get_lists`	All your shopping lists with their ids.
`get_items`	Items on a list — checked (already have) vs unchecked (to buy).
`add_items`	Add one or many items in a single call (name, quantity, unit).
`edit_items`	Check/uncheck, rename, or re-quantity items — batched.
`delete_items`	Remove items entirely.

Add this server

Host a copy with our keys and logs.

Server facts

Documentation

listonic-mcp

Install

Add to your agent

Launch params

Tools

Good to know

Make it yours

Credits

License

Listonic

Tools

Questions

How do I install Listonic?

Does Listonic need an API key?

What transport does Listonic use?

When was Listonic last checked?