Antoine Hue
•
1 April 2026
•
5 mins
OuEstCharlie Woof is the photo and video gallery companion to your AI assistant (Claude Desktop, Goose, VS Code / GitHub Copilot…). It complements those powerful tools with a searchable gallery. Your photos and videos remain exactly where they are — on your own drives (local or mounted).
Woof runs as a local MCP server. It connects to your AI desktop client (Claude Desktop, Goose…) and exposes your photo library as a set of tools.
Woof also provides a plugin containing skills to create workflows in the AI harness.
See also the specific post: Step by Step install of OuEstCharlie Woof in Claude Desktop
Python packages of OuEstCharlie Woof are managed by Astral uv and the command uvx. uv might be already available on your system.
System prerequisites (all install options):
brew install inih brotli gettext (required by pyexiv2 at runtime)Reference: Getting Started with Local MCP Servers on Claude Desktop
Open (or create) ~/Library/Application Support/Claude/claude_desktop_config.json and add or update mcpServers:
{
"mcpServers": {
"woof": {
"command": "uvx",
"args": ["--python", "3.14", "--from", "ouestcharlie-woof", "woof-bridge"]
}
}
}
Restart Claude Desktop. Woof will appear as an MCP integration, and the gallery will render as an interactive panel inside your conversation.
To install in VS Code:
The composed configuration should be:
{
"servers": {
"woof-bridge": {
"command": "uvx",
"args": [
"--python",
"3.14",
"--from",
"ouestcharlie-woof",
"woof-bridge"
],
"type": "stdio"
}
},
"inputs": []
}
Check if woof-bridge is activated through the “MCP: List Servers” from the Command Palette.
Reference: Goose MCP extensions documentation
Goose supports MCP servers via its extension system.
Either add through the user interface as a Custom Extension:

Setup Woof extension in Goose
Or add the following to your Goose configuration (~/.config/goose/config.yaml):
extensions:
woof:
type: stdio
cmd: uvx
args: ["--python", "3.14", "--from", "ouestcharlie-woof", "woof-bridge"]
enabled: true
Other clients support MCP Apps, for example Codex.
See the MCP Extension Support Matrix
Woof provides optional skills with workflows, see the Tutorial section below. To install the plugin containing the skills, reference this repository as ouestcharlie/ouestcharlie-woof:
Once Woof is connected to your AI client, ask it to register your photo folder:
“Add a local library to Woof pointing to /Users/yourname/Pictures”
Woof supports any folder on a local drive — including folders synced from iCloud Drive, OneDrive, or Google Drive, as long as the files are locally available.
Trigger the indexer to scan your photos and build the metadata index:
“Index my local library”
Woof will launch the indexing agent, which will:
Indexing speed is roughly 10 to 100 seconds per 1,000 photos depending on format and hardware.
Once indexing is complete, just ask:
“Show me photos in Woof from last July”
“In Woof, show me pictures taken near Paris”
“Search Woof for photos with ‘Tour Eiffel’ in the description”
“How many photos do I have in Woof?”
The gallery panel will appear inline in your conversation with matching results.
Ouestcharlie Woof AI native photo gallery - Search, browse, sort and enrich photos in your AI harness
Woof supports local filesystem and cloud_mount libraries on macOS, Linux, and Windows:
Native cloud storage (S3, Azure, GCS, OneDrive API) is planned.
Like it? Share it!