<h1 align="center">Memories Wrapped</h1>
<div align="center">
<img width="581" height="451" alt="Screenshot 2025-12-07 at 8 00 22 PM" src="https://github.com/user-attachments/assets/f914d7d7-448e-403c-944a-9f058016fded" />
</div>

Memories Wrapped is an MCP server that creates a summary of the photos you took using Apple Photos.

The project is heavily inspired from the [Memory Journal MCP Server](https://github.com/Siddhant-K-code/memory-journal-mcp-server) and [this tweet](https://x.com/Siddhant_K_code/status/1996538217483678184).
## Prerequisites 
- [Claude Desktop](https://www.claude.com/download)
- [uv](https://github.com/astral-sh/uv)

## Getting Started

1. Clone the git repository
```bash
git clone git@github.com:niyabits/memories-wrapped-mcp-server.git
```

2. Install dependencies 
```bash
uv sync
```

3. Configure the MCP Server
```json
{
  "mcpServers": {
    "year-wrapped": {
        "command": "/Users/<username>/.local/bin/uv",
        "args": [
          "--directory",
          "<repository-path>/memories-wrapped-mcp-server",
          "run",
          "year_wrapped.py"
        ]
      }
    },
}
```

> [!NOTE]
> Make sure to replace the `<username>` and `<repository-path>` <br />
> You can find the value for `command` using: `which uv` <br />
> And `<repository-path>` is where you cloned the git repository.

4. Open Claude and ask for your year wrapped 🥳