1. Conduid
  2. Developer Tools
  3. grocy-api
MCP server · Developer Tools

grocy-api

by · github.com/saya6k/mcp-grocy-api

Model Context Protocol (MCP) wrapper for grocy API

Unclaimed grocymcprestapihttptestingclinedevelopmenttypescript
InstallView source
42Fair

Scored yesterday · breakdown

About grocy-api

grocy-api is an MCP server published by git+saya6k in the Developer Tools category: model Context Protocol (MCP) wrapper for grocy API.

The repository has 29 stars and 0 forks, with the last commit 4 months ago. Recent commit activity is the strongest signal that reported issues will get attention.

Install

Install
npx mcp-grocy-api
Claude Code
claude mcp add grocy-api -- npx -y mcp-grocy-api
npx
npx -y mcp-grocy-api

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about grocy-api

Powered by Claude · Grounded in docs

I know everything about grocy-api. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

4 checks have not been run yet.

README

MCP Grocy API

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.

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.

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About grocy-api

How do I install grocy-api?

Run npx mcp-grocy-api, then add the server to your MCP client's configuration.

Is grocy-api safe to use with an AI agent?

Its trust score is 42 out of 100 (fair). It passes 1 of the 2 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is grocy-api still maintained?

Yes — the last commit was 4 months ago. The repository has 29 stars and 0 forks.