Content
# MCP Grocy API
[](https://www.npmjs.com/package/mcp-grocy-api)
[](https://github.com/saya6k/mcp-grocy-api/pkgs/container/mcp-grocy-api)
[](LICENSE)
[](https://github.com/saya6k/mcp-grocy-api/actions/workflows/validate-config.yml)
[](https://github.com/saya6k/mcp-grocy-api/actions/workflows/pipeline.yml)
[](https://modelcontextprotocol.io)
This project is a specialized fork of [mcp-rest-api](https://github.com/dkmaker/mcp-rest-api), refactored to work specifically with Grocy's API.
## Installation
### NPM
```bash
git clone -b main https://github.com/saya6k/mcp-grocy-api.git
cd mcp-grocy-api
npm install
npm run build
```
### Docker
```bash
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
[](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Fsaya6k%2Fhassio-addons)
The MCP Grocy API is available as a Home Assistant add-on through [saya6k's add-on repository](https://github.com/saya6k/hassio-addons).
## Usage
To use the API, you need to provide the Grocy API URL and API key:
```bash
# 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:
```bash
# 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](src/resources/api-reference.md).
### Configuration
For configuration options, see the [Configuration Guide](src/resources/config.md).
## Development
### Prerequisites
- Node.js 18 or higher
- Grocy instance (or use `--mock` for development)
### Testing
```bash
npm test
```
## License
This project is licensed under the [MIT License](LICENSE).
You Might Also Like
UI-TARS-desktop
UI-TARS-desktop is part of the TARS Multimodal AI Agent stack.
inbox-zero
Inbox Zero is an open source AI email assistant to help you manage emails...
DesktopCommanderMCP
Desktop Commander MCP allows AI-driven file management and terminal command...
asyncmcp
asyncmcp provides async transport layers for MCP servers using queues.
agent
Stakpak Agent: A secure DevOps tool with mTLS, dynamic secret management,...
skynet-agent
AI platform with dual-layer memory for conscious memory control and MCP access.