Smart Photo Journal

Provides local photo search and analysis via MCP, including location, label, people search, and pattern analysis.

python

GitHub Stars

python

Language

4 months ago

First Indexed

3 weeks 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": {
    "mcp-mirror-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 enables you to search and analyze your photo library through a focused, command-driven interface. You can locate photos by location, labels, or people, analyze taking patterns, and leverage fuzzy matching to handle uncertain queries. This server runs locally and processes your photo queries, helping you quickly organize and explore your collection while keeping data on your device.

How to use

You interact with the Smart Photo Journal MCP Server through an MCP client. Start the server first, then issue queries through the client to perform searches and analyses. Practical usage patterns include locating photos by location, finding images by labels or keywords, and extracting insights about when you typically take photos.

How to install

Prerequisites you need to satisfy before installation are: a macOS environment and a Photos library, plus the MCP runtime you’ll use to start the server.

Step 1: Clone the project repository.

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

Step 2: Install dependencies using the MCP runtime tool.

uv sync

Step 3: Configure the MCP server. Update your configuration to include the server entry shown below.

{
  "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"
      ]
    }
  }
}

Step 4: Start the MCP server. You can either run the command below or open the MCP client interface to start it.

uv run server.py

Notes for setup you’ll see a popup requesting authorization to access your Photos library. This access remains local to your device and is not shared with others except Claude services.

Additional configuration and notes

When the server starts, you will see a startup message indicating that the Smart Photo Journal MCP server is now ready to process photo queries. Ensure your Photos library is loaded in macOS for accurate results.

Security and privacy focus: interactions stay local to your machine. You control which photos the server can access, and your data is not sent to external services beyond the intended MCP workflow.

Example usage scenarios

Family & Friends Album Organizer: use the people-search capability to locate photos featuring specific individuals, such as family members or friends.

Vacation Highlights: use location-search to filter photos from a destination you visited.

Throwback Fun: find past birthday photos with label-search for “Birthday” to relive those moments.

Understand Your Photography Habits: run photo-analysis to uncover patterns like the most common times or days you take photos, helping you plan future shoots.

Available tools

Location Search

Find photos taken in a specific location using a query with a location value.

Label Search

Search photos by labels or keywords to filter by themes like Birthday, Beach, or Vacation.

People Search

Locate photos that feature specific individuals or groups based on names or identifiers.

Photo Analysis

Analyze your library to reveal patterns such as common shooting times and days.

Built by

VeilStrat

AI signals for GTM teams