Skip to main content
Glama
Sign In
saya6k

MCP Grocy API

by saya6k
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

MCP Grocy API

WARNING

This project is no longer maintained.

The maintainer no longer uses Grocy and cannot review issues, accept PRs, or ship updates. This repository has been archived as of 2026-05-27. If you'd like to continue development, please fork and maintain your own version, or look for an active community fork.

npm version Docker Image License Configuration Status CI/CD Pipeline MCP Compatible

This project is a specialized fork of mcp-rest-api, refactored to work specifically with Grocy's API.

Installation

NPM

git clone -b main https://github.com/saya6k/mcp-grocy-api.git
cd mcp-grocy-api
npm install
npm run build

Docker

docker run -e GROCY_APIKEY_VALUE=your_api_key -e GROCY_BASE_URL=http://your-grocy-instance ghcr.io/saya6k/mcp-grocy-api:latest

Home Assistant Add-on

Open your Home Assistant instance and show the add add-on repository dialog with a specific repository URL pre-filled.

The MCP Grocy API is available as a Home Assistant add-on through saya6k's add-on repository.

Related MCP server: grocy-mcp

Usage

To use the API, you need to provide the Grocy API URL and API key:

# Start the server with environment variables
npx cross-env GROCY_BASE_URL=http://your-grocy-instance GROCY_APIKEY_VALUE=your_api_key mcp-grocy-api

Or to start in development mode:

# Start the server with sample/mock responses (no real Grocy instance needed)
npx cross-env GROCY_BASE_URL=http://your-grocy-instance GROCY_APIKEY_VALUE=your_api_key mcp-grocy-api --mock

Environment Variables

  • GROCY_BASE_URL: Your Grocy API URL

  • GROCY_APIKEY_VALUE: Your Grocy API key

  • GROCY_ENABLE_SSL_VERIFY: Whether to verify SSL certificate

  • REST_RESPONSE_SIZE_LIMIT: REST API response size (default: 10000 = 10KB)

Documentation

API Reference

For the full API reference, see the API Reference.

Configuration

For configuration options, see the Configuration Guide.

Development

Prerequisites

  • Node.js 18 or higher

  • Grocy instance (or use --mock for development)

Testing

npm test

License

This project is licensed under the MIT License.

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

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • grocy-mcp

    rusty4444
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to manage household operations including groceries, inventory, chores, recipes, and shopping lists through the Grocy self-hosted ERP system.
    4
    MIT

  • grocy-mcp

    anishanilkumar
    A
    license
    A
    quality
    C
    maintenance
    MCP server for Grocy that enables AI assistants to read and manage pantry stock, product catalogs, and shopping lists, with safety checks against common errors.
    27
    MIT

  • grocy-mcp

    Rubio-Enterprises
    A
    license
    C
    quality
    C
    maintenance
    Enables AI agents and terminal users to manage Grocy household inventory, shopping lists, recipes, chores, and related household operations through MCP tools and a command-line interface.
    89
    MIT