Ginger MCP server

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

This is a connector, not a website. There is nothing to do on this page - you add the address below to Claude (or another AI assistant), sign in with your normal Ginger account, and it can then work with your Ginger projects for you.

What it can do

Look things up. List your projects and the people on them, walk the folder structure, find and filter documents across a whole project, read a file's version history, and fetch a download link.

Change things. Create folders, upload files, and delete files. Deleting moves a file to the project trash and can be undone, either with this connector or in the Ginger web interface. Permanent deletion is not available here, on purpose.

What it will not do: rename or move things, change metadata, touch tasks, or permanently destroy anything.

Already connected before September 2026? Your connection is read-only and will refuse to upload or delete. Remove the connector and add it again to be asked for the new permissions. Seeing the upload tool in the list is not enough - the permission travels with your sign-in, not with the tool list.

How to connect it

Step 1 - add the connector.
In Claude Desktop, open Settings, then Connectors, then "Add custom connector", and paste this address: 
https://ginger-mcp.bimurl.dk/mcp
Leave the OAuth fields empty. Click Add.
Step 2 - click Connect and sign in.
You will be sent to Ginger to sign in and approve access. This is the same login you already use, and your password is never seen by this connector.
Step 3 - check it works.
Ask your assistant: "list my Ginger projects". If you get a list back, you are connected.

To disconnect later, remove the connector in Claude Desktop, or revoke access from your Ginger account.

Uploading files

There are two different situations here and they behave very differently. This catches people out, so it is worth two minutes.

Something the assistant wrote: yes

A summary, a list, a table, notes, a CSV it just produced. The assistant has the content already, so it can upload it straight into a Ginger folder. This works well.

A file already sitting on your computer: no, not with this connector

This connector runs on a server, not on your machine. It has no way to reach your Documents folder, your desktop or a network drive. Asking it to upload a drawing from your computer cannot work, no matter how the request is phrased.

For a small text file the assistant can read the content and pass it along. For a real drawing, a PDF or a model file, that is not practical: the content would have to travel through the conversation itself, which is slow, expensive and limited to about one megabyte.

If you need to upload files from your own computer, there is a second version of this connector that runs locally, on your machine, where it can read your files directly. It needs a configuration file and an API key, so it is a job for someone comfortable doing that. The repository README has the steps. The two versions can be used side by side, and they talk to the same Ginger projects.

Downloading files to your computer

This connector gives the assistant a secure download link for each file. It does not save anything to your computer itself, so whether the file actually lands in a folder depends on the assistant you are using:

Two practical notes. Download links expire after 5 minutes, so a large batch should be fetched as it goes rather than collected up first. And files are fetched one at a time: there is no "download this whole folder" action, so the assistant works through the list and rebuilds the folder structure on your side.

Good to know

Sign-inhappens on Ginger, not here. This connector never sees your password, and stores nothing.
Your permissionsare unchanged. The connector can only see and change what you could already see and change in Ginger yourself.
Deletingmoves a file to the project trash and can be undone. Nothing here destroys a file permanently.
Everyone sees itUploads and deletions are immediately visible to the whole project, exactly as if you had done them in the web interface.
Download linksexpire after 5 minutes.
API keysstill work for developers using a config file. See the README in the repository.

Built by 3dbyggeri. Health endpoint: /healthz.