# Filmlog

> Filmlog is a paid MCP server for personal profiles. Mac MCP server that lets AI assistants query and update your Filmlog movie diary. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** macOS, API
- **Website:** https://filmlog.cc
- **Repository:** https://github.com/techumbely/filmlog-mcp
- **MCP Registry name:** cc.filmlog/filmlog
- **Categories:** personal profiles
- **Listing updated:** 2026-11-18

## About

The MCP server ships inside the Filmlog Mac app, so an assistant can look through your own library: what you watched and when, your watchlist, challenges and statistics. The README says it can also propose changes such as adding a film to the watchlist, and those only apply after you approve them in Filmlog.

The extension is a small Claude Desktop package that launches the server locally over stdio. Filmlog answers from the Mac itself, and the README notes that whatever the server returns becomes part of the conversation with the assistant. Writes are off until enabled in Filmlog, and by default each change asks for confirmation.

It suits people who already keep a Filmlog diary on a Mac and want to query or tidy it through Claude Desktop. The server needs Filmlog Plus, Filmlog 2026.9 or later from the Mac App Store, and the app opened at least once.

## Features

- **Library queries:** Reads watched films, the watchlist, challenges and statistics from the local Filmlog library.
- **Approval-gated changes:** Proposed edits such as watchlist additions, ratings and follows wait for confirmation in Filmlog.
- **Local stdio transport:** The server runs on the Mac and talks to the AI client over stdio rather than a remote endpoint.
- **Claude Desktop install:** Distributed as a single .mcpb file that installs with a double-click.
- **Other client config:** Filmlog's settings page provides a configuration block for MCP clients besides Claude Desktop.

## Good for

- Asking an assistant what you watched in a given month or year
- Checking your watchlist and challenge progress without opening the app
- Adding films to the watchlist or rating one through a chat request
- Pulling statistics about your viewing habits into a conversation

## Install

### Claude Code (Terminal)

```sh
claude mcp add filmlog -- npx -y https://github.com/techumbely/filmlog-mcp/releases/download/1.0.4/filmlog.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "filmlog": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/techumbely/filmlog-mcp/releases/download/1.0.4/filmlog.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "filmlog": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/techumbely/filmlog-mcp/releases/download/1.0.4/filmlog.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "filmlog": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/techumbely/filmlog-mcp/releases/download/1.0.4/filmlog.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "filmlog": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/techumbely/filmlog-mcp/releases/download/1.0.4/filmlog.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "filmlog": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/techumbely/filmlog-mcp/releases/download/1.0.4/filmlog.mcpb"
      ]
    }
  }
}
```

## Tools

- `queryWatchlist`: Read the watchlist.
- `querySeenFilms`: Read films already watched.
- `queryFilmDetails`: Read details for a film.
- `queryChallenges`: Read challenges and progress.
- `queryStatistics`: Read viewing statistics.
- `queryLibraryByFacet`: Query the library by facet.
- `queryFilmFacts`: Read facts about films.
- `searchFilms`: Search films.
- `addToWatchlist`: Add a film to the watchlist, subject to approval.
- `setFilmRating`: Set a film rating, subject to approval.
- `setFilmFavorite`: Mark a film as favorite, subject to approval.
- `setPersonFollow`: Follow or unfollow a person, subject to approval.
- `setCinemaPin`: Pin or unpin a cinema, subject to approval.

## FAQ

### Does the server run on Windows or iPhone?

The README describes it as a Mac server that runs alongside the Mac app, and the install steps are for a Mac with Filmlog installed from the Mac App Store.

### Do I need a paid plan?

The MCP server is listed as part of Filmlog Plus, so yes, the README says it requires that subscription or one-time purchase.

### Can the assistant change my diary without asking?

Changes are off until allowed in Filmlog, and by default Filmlog asks before applying each one.

### Where does my data go?

The README says the server runs on your Mac and Filmlog answers locally, though returned content becomes part of the assistant conversation.

### Is Filmlog free?

No. Filmlog is a paid product.

### How do I add Filmlog to Claude Code?

Run this command in your terminal: claude mcp add filmlog -- npx -y https://github.com/techumbely/filmlog-mcp/releases/download/1.0.4/filmlog.mcpb

### What are the best alternatives to Filmlog?

The closest alternatives to Filmlog are Asteria, Zodiacs, Personal web presence audit — Atom, Izzet Yildirim and numbrU.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Asteria](https://ai-powered.com/mcp/asteria): Asteria is a free MCP server for personal profiles.
- [Zodiacs](https://ai-powered.com/mcp/zodiacs-2): Zodiacs is an MCP server for personal profiles.
- [Personal web presence audit — Atom](https://ai-powered.com/mcp/personal-web-presence-audit-atom): Personal web presence audit — Atom is an MCP server for personal profiles.
- [Izzet Yildirim](https://ai-powered.com/mcp/izzet-yildirim): Izzet Yildirim is an open-source MCP server for personal profiles.
- [numbrU](https://ai-powered.com/mcp/numbru): numbrU is an MCP server for personal profiles.
- [FateSign BaZi](https://ai-powered.com/mcp/fatesign-bazi): FateSign BaZi is a freemium MCP server for personal profiles.
- [Jonas Splinter (jsplinter.nl)](https://ai-powered.com/mcp/jonas-splinter-jsplinter-nl): Jonas Splinter (jsplinter.nl) is a free MCP server for personal profiles.

---
Source: https://ai-powered.com/mcp/filmlog
