Smart Photo Journal MCP Server

by siddhant-k-code

Not rated
GitHub

About

Create a memory journal from your local photos in the macOS Photos library.

Details

Author
siddhant-k-code
Categories
File Management, Other, AI

Setup

Install Smart Photo Journal MCP Server in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/siddhant-k-code/memory-journal-mcp-server

Follow the installation instructions in the repository README, then restart your MCP client.

Create a memory journal from your local photos in the macOS Photos library.

Smart Photo Journalis an MCP server designed to help you search and analyze your photo library with powerful, intuitive tools. Whether you're reminiscing about family moments or looking for a specific photo with friends, this server has got you covered! πŸŽ‰

Inspired by:burningion/video-editing-mcpA huge shoutout to@burningionfor the innovative idea of using MCP for creative media management!

- Location Search:Find photos from specific places with ease. 🌍
- Label Search:Search photos by keywords or labels like "Birthday," "Beach," or "Vacation." πŸŽ‰
- People Search:Quickly locate photos featuring specific people. πŸ‘₯
- Photo Analysis:Discover fun insights like the most popular times and days for your photo shoots. πŸ•°οΈ
- Fuzzy Matching:Not sure of the exact name? Don't worry! The server supports fuzzy matching for flexibility. πŸ”
- Ensure you have macOS with a Photos library.
- Install
uvto manage dependencies and run the server.

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

Configure the MCP server. Update yourclaude_desktop_config.jsonwith the following configuration:

{ "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 following command or just open Claude Desktop:

Note:Replace<YOUR_DEVICE_USERNAME>and<PATH_TO_CLONED_DIR>with your actual device username and the path to the cloned directory. You will get a popup to authorize the server to access your photos. It will be in local only, and no data will be shared with anyone except Claude services.

When the server starts, you'll see:

Starting Smart Photo Journal MCP server.

It's now ready to process your photo queries! πŸŽ‰

- Description: Find photos taken in a specific location.
- Input Example:

{ "location": "Udaipur" }
Found 5 photos from Udaipur: πŸ“· IMG_1234.jpg ...

- Description: Search for photos by labels or keywords.
- Input Example:

{ "label": "Birthday" }
Photos labeled as 'Birthday' (3 found): πŸ“· IMG_5678.jpg ...

- Description: Find photos containing specific people.
- Input Example:

{ "person": "Maa" }
Photos with Maa (10 found): πŸ“· IMG_9101.jpg ...

- Description: Analyze patterns in your photo library, such as the most common times or days for photo shoots.
- Input Example:

{}
πŸ“Έ Photo Taking Patterns: Total Photos: 200 ...

Want to gather all your family moments in one place? Use thepeople-searchtool with names like "Papa" or "Mom" or "Any Friend" to find photos with specific people.

Search for photos from your vacation destination using thelocation-searchtool.

Curious about your past birthday photos? Uselabel-searchwith "Birthday" and relive the fun!

Use thephoto-analysistool to understand when and where you take most of your photos. Plan your next shoot accordingly!

- Ensure your Photos library is loaded in macOS.
- Be as specific as possible with search queries for more accurate results.
- Use fuzzy matching for flexibility when you're unsure of the exact name.

Filesystem agent memory working with consolidation Daemon on your machine

A lightweight plugin to list all files and folders on the current macOS user's desktop.

Persistent memory for AI agents. Store and retrieve files via 14 MCP tools with OAuth 2.0 auth. Free 10GB tier.

Your AI's memory shouldn't live on someone else's server β€” 12 MCP tools that give it persistent context from your local markdown, no cloud, no API keys, single binary.

An MCP server for manipulating Xcode project files (.xcodeproj) using Swift. Requires Docker and macOS.

Parses various file formats using the 302.AI API, requiring a 302AI_API_KEY.

A local server that allows AI to execute Windows CMD commands, read/write files, and manage directories within a specified path.

An AI-powered MCP server for advanced file system operations, including search, comparison, and security analysis.

Securely browse and read files within an Android project, with built-in validation and access controls for sensitive directories.

Build a persistent, local knowledge base in Markdown files through conversations with LLMs.

No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.