Smart Photo Journal

MCP server designed to help you search and analyze your photo library (iCloud - Apple photos)

python

23

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "siddhant-k-code-memory-journal-mcp-server": {
      "command": "/Users/<YOUR_DEVICE_USERNAME>/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/<PATH_TO_CLONED_DIR>/memory-journal-mcp-server",
        "run",
        "server.py"
      ]
    }
  }
}

Smart Photo Journal MCP Server lets you search and analyze your photo library from a local server, enabling practical queries like locating photos by location, labels, or people, and discovering patterns in your collection. It provides a streamlined way to interact with your photos through an MCP client, keeping your data processing self-contained on your device.

How to use

You interact with the Smart Photo Journal MCP Server through an MCP client. Start the local server, then use the client tools to perform location searches, label searches, people searches, and photo analysis. For best results, provide clear search terms and, when possible, use fuzzy matching to accommodate approximate names.

How to install

Prerequisites You need macOS with a Photos library and the uv runtime installed to manage dependencies and run the MCP server.

git clone https://github.com/Siddhant-K-code/memory-journal-mcp-server.git
cd memory-journal-mcp-server

uv sync

Configure the MCP server by saving the following configuration to your client’s MCP settings or editor where you manage your MCP servers. Replace placeholders with your actual paths.

{
  "mcpServers": {
    "smart-photo-journal": {
      "command": "/Users/<YOUR_DEVICE_USERNAME>/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/<PATH_TO_CLONED_DIR>/memory-journal-mcp-server",
        "run",
        "server.py"
      ]
    }
  }
}

Start the server with the following command or open your MCP client interface and start it from there.

uv run server.py

Note: You will be prompted to authorize the server to access your Photos library. This access remains local to your device and data is not shared with others except Claude services.

Additional setup notes

When the server starts, you should see a confirmation like: Starting Smart Photo Journal MCP server. The server is now ready to process your photo queries.

Available tools

Location Search

Find photos taken in a specific location by matching the provided location term.

Label Search

Search photos by labels or keywords such as Birthday, Beach, or Vacation.

People Search

Locate photos containing specific people by name or identifier.

Photo Analysis

Analyze patterns like most common times and days for taking photos.

Fuzzy Matching

Allow flexible searches when exact terms are uncertain.