# Albumen

> Albumen is an open-source MCP server for files and documents. Read-only MCP over an open-source photo library that never alters your originals. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Linux, macOS, Windows
- **Repository:** https://github.com/jay-the-maker/albumen/tree/HEAD/mcp
- **MCP Registry name:** io.github.jay-the-maker/albumen
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents), [design and media](https://ai-powered.com/categories/design-and-media)
- **Listing updated:** 2026-11-18

## About

Albumen is an early-stage open-source photo library whose design promise is that originals and metadata are never lost. Files are stored bit-exact with no recompression or stripping, EXIF, XMP, IPTC, GPS and sidecars stay, and every copy is verified with SHA-256. Sources are read-only, and a destination inside a source is refused with no override.

The MCP server speaks stdio and lets an agent search and browse the library, including metadata search by capture date, camera, lens, GPS box and XMP or IPTC keywords and captions, and read a ledger of stored files, analyses and destinations. Export and upload tools are off until the process starts with --enable-export or --enable-upload, and there is no delete tool at all.

Storage stays where you put it, such as local disk, NAS, SMB, SFTP, WebDAV, S3 or Backblaze B2. Native macOS, iOS and Android apps and an on-disk catalog are not built yet. The server is available as a Rust build or an OCI container, and metadata search needs ExifTool.

## Features

- **Bit-exact originals:** No recompression, transcoding or metadata stripping.
- **Metadata search:** Search by date, camera, lens, GPS box and keywords.
- **Ledger:** Lists stored files, on-device analyses and destinations.
- **Opt-in export:** Export and upload tools are off unless enabled.
- **No delete tool:** Agents cannot remove or rewrite originals.
- **Bring your storage:** Local disk, NAS, S3, B2 and more.

## Good for

- Find photos by camera and date range through an assistant
- Review what the library has stored and analysed
- Export a copy to a backup destination with verification
- Keep an archive agent-readable but not editable

## Install

### Claude Code (Terminal)

```sh
claude mcp add albumen -- docker run -i --rm ghcr.io/jay-the-maker/albumen-mcp:0.1.1
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "albumen": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/jay-the-maker/albumen-mcp:0.1.1"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "albumen": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/jay-the-maker/albumen-mcp:0.1.1"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "albumen": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/jay-the-maker/albumen-mcp:0.1.1"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "albumen": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/jay-the-maker/albumen-mcp:0.1.1"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "albumen": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/jay-the-maker/albumen-mcp:0.1.1"
      ]
    }
  }
}
```

## FAQ

### Can an agent delete my photos?

No. The server has no delete tool and sources are read-only.

### Is it a hosted service?

No. You bring your own storage.

### What is its status?

Early-stage; native apps and the on-disk catalog are not built yet.

### What does metadata search need?

ExifTool on PATH.

### Is Albumen free?

Yes. Albumen is open source, so you can use and self-host it for free.

### How do I add Albumen to Claude Code?

Run this command in your terminal: claude mcp add albumen -- docker run -i --rm ghcr.io/jay-the-maker/albumen-mcp:0.1.1

### What are the best alternatives to Albumen?

The closest alternatives to Albumen are HyperFrames by HeyGen, next-ai-draw-io, mcp-for-blender, ffmpeg-skill and cursor-talk-to-figma-mcp.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [next-ai-draw-io](https://ai-powered.com/mcp/next-ai-draw-io-2): next-ai-draw-io is an open-source MCP server for ai models and llm tooling.
- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [cursor-talk-to-figma-mcp](https://ai-powered.com/mcp/cursor-talk-to-figma-mcp): cursor-talk-to-figma-mcp is an open-source MCP server for design and media.
- [SSRS2](https://ai-powered.com/mcp/ssrs2): SSRS2 is an MCP server for files and documents.
- [Design Feeds](https://ai-powered.com/mcp/design-feeds): Design Feeds is a freemium MCP server for design and media.
- [Csv](https://ai-powered.com/mcp/csv): Csv is a freemium MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/albumen
