Smart Photo Journal MCP Server
Smart Photo Journal is 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-mcp A huge shoutout to @burningion for the innovative idea of using MCP for creative media management!
<a href="https://glama.ai/mcp/servers/51jiworg5k"><img width="380" height="200" src="https://glama.ai/mcp/servers/51jiworg5k/badge" alt="Smart Photo Journal Server MCP server" /></a>
Features
- 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.
Getting started
Prerequisites
- Ensure you have macOS with a Photos library.
- Install uv to manage dependencies and run the server.
Installation
- Clone the repository:
- Install dependencies using
uv:
- Configure the MCP server. Update your
claude_desktop_config.jsonwith the following configuration:
- 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.
MCP Server Initialization
When the server starts, you'll see:
It's now ready to process your photo queries!
Usage
Available Tools
- Location Search
- Label Search
- People Search
- Photo Analysis
Example Use-Cases
1. **Family & Friends Album Organizer**
Want to gather all your family moments in one place? Use the
people-search tool with names like "Papa" or "Mom" or "Any Friend" to find photos with specific people.2. **Vacation Highlights**
Search for photos from your vacation destination using the
location-search tool.3. **Throwback Fun**
Curious about your past birthday photos? Use
label-search with "Birthday" and relive the fun!4. **Understand Your Photography Habits**
Use the
photo-analysis tool to understand when and where you take most of your photos. Plan your next shoot accordingly!Tips for Best Results
- 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.
Smart Photo Journal MCP Server
Smart Photo Journal is 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-mcp A huge shoutout to @burningion for the innovative idea of using MCP for creative media management!
<a href="https://glama.ai/mcp/servers/51jiworg5k"><img width="380" height="200" src="https://glama.ai/mcp/servers/51jiworg5k/badge" alt="Smart Photo Journal Server MCP server" /></a>
Features
- 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.
Getting started
Prerequisites
- Ensure you have macOS with a Photos library.
- Install uv to manage dependencies and run the server.
Installation
- Clone the repository:
- Install dependencies using
uv:
- Configure the MCP server. Update your
claude_desktop_config.jsonwith the following configuration:
- 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.
MCP Server Initialization
When the server starts, you'll see:
It's now ready to process your photo queries!
Usage
Available Tools
- Location Search
- Label Search
- People Search
- Photo Analysis
Example Use-Cases
1. **Family & Friends Album Organizer**
Want to gather all your family moments in one place? Use the
people-search tool with names like "Papa" or "Mom" or "Any Friend" to find photos with specific people.2. **Vacation Highlights**
Search for photos from your vacation destination using the
location-search tool.3. **Throwback Fun**
Curious about your past birthday photos? Use
label-search with "Birthday" and relive the fun!4. **Understand Your Photography Habits**
Use the
photo-analysis tool to understand when and where you take most of your photos. Plan your next shoot accordingly!Tips for Best Results
- 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.