Ginger MCP server

Lets an AI assistant read the files in your Ginger projects. Version 0.1.0.

This is a connector, not a website. There is nothing to click here - you add the address below to Claude (or another AI assistant), and it can then look through your Ginger projects for you.

What it can do

Read only. It can list your projects, walk the folder structure, list and filter documents, look at a file's version history, and fetch a download link for a file. It cannot upload, rename, move or delete anything.

How to connect it

Step 1 - get your API key.
Sign in to Ginger, go to /api_key, and copy the key shown there. It is labelled "Glasshouse API key" - that is an old name, it is simply your API key. Treat it like a password.

Step 2 - add the connector.
In Claude Desktop, open Settings, then Connectors, then "Add custom connector", and use this address:

https://ginger-mcp.bimurl.dk/mcp

You will need to add one header, because this version does not yet have a "Connect" button:

Authorization: Bearer YOUR_API_KEY

Step 3 - check it works.
Ask your assistant: "list my Ginger projects". If you get a list back, you are connected.

Config file version

If your client uses a JSON config file rather than a settings screen:

{
  "mcpServers": {
    "ginger": {
      "command": "npx",
      "args": ["mcp-remote", "https://ginger-mcp.bimurl.dk/mcp", "--header", "Authorization:Bearer YOUR_API_KEY"]
    }
  }
}

Good to know

Your key	is never stored by this server. It is passed straight through to Ginger on each request.
Your permissions	are unchanged. The connector can only see what you can already see in Ginger.
Download links	expire after 5 minutes.
Lost your key	Rotate it on the `/api_key` page. The old one stops working immediately, so update it here too.

Built by 3dbyggeri. Health endpoint: /healthz.