
amberflip
com.amberflip/amberflip
Convert, compress and edit pictures, video, audio and PDFs offline. Nothing is uploaded.
Documentation
Amberflip for AI apps
Amberflip converts, compresses and edits pictures, video, sound, PDFs and documents on your own computer. Connect it to Claude, Cursor, VS Code and other AI apps over MCP, and the AI can convert, trim, redact or shrink your files while nothing is uploaded: the AI app and Amberflip share the disk, not the bytes.
This repository holds the manifests, install instructions and skills for that connection. It contains no source code and no program files. The Amberflip application is proprietary, with a free trial: see Trial and licence.
Website: https://amberflip.com
What you get
- 38 tools over MCP (stdio): convert between formats, compress, trim and join video, fix audio, crop and annotate pictures, merge, split and redact PDFs, strip hidden metadata, zip and unzip.
- Offline. No network listener, no window, no upload. Answers contain the paths of the new files, never the contents of your files.
- Safe by default. Results are new files next to the originals (or in a folder you choose); originals are never changed.
- Windows, Linux and macOS, with the same engine as the Amberflip app and the
amberflip-clicommand.
Example: "Make these 12 phone photos JPG, remove the GPS location, and put them in one ZIP." The AI
calls convert, strip_metadata and zip; the files stay on your computer.
Install
You need one of:
- The Amberflip app (https://amberflip.com). Open Settings, AI apps and press Connect. It adds Amberflip to every AI app it finds on the computer (Claude, Claude Code, Codex, Cursor, VS Code, Windsurf, Zed, Gemini CLI, Antigravity, LM Studio) and installs the skills below. Disconnect takes the entry out again.
- The
amberflip-clipackage from npm, started by your AI app withnpx. It needs Node.js 18 or newer. The steps below use this.
Supported systems: Windows x64, Linux x64, and macOS 13 or later (Apple silicon and Intel). For
video and sound Amberflip uses FFmpeg: the Windows and macOS packages include it, on Linux install
it with your package manager (apt install ffmpeg and the like). Ghostscript (PDF) and
LibreOffice (office documents) are optional extras; an operation whose program is missing does not
appear in list_operations.
The server command is the same everywhere:
npx -y amberflip-cli mcp
Claude Code
claude mcp add --transport stdio --scope user amberflip -- npx -y amberflip-cli mcp
Or install the plugin, which adds the server and the skills:
/plugin marketplace add ismoil77/amberflip-mcp
/plugin install amberflip@amberflip
Claude Desktop
Add this to claude_desktop_config.json and restart Claude:
{
"mcpServers": {
"amberflip": {
"command": "npx",
"args": ["-y", "amberflip-cli", "mcp"]
}
}
}
The file is at %APPDATA%\Claude\claude_desktop_config.json on Windows,
~/Library/Application Support/Claude/claude_desktop_config.json on macOS and
~/.config/Claude/claude_desktop_config.json on Linux. If Claude cannot find npx, put the full
path from where npx (Windows) or which npx (macOS, Linux) in command.
Cursor
Add to Cursor
(opens Cursor), or add the same JSON as above to ~/.cursor/mcp.json.
VS Code (Copilot)
Add to VS Code (opens VS Code), or run this in a terminal (macOS and Linux):
code --add-mcp '{"name":"amberflip","type":"stdio","command":"npx","args":["-y","amberflip-cli","mcp"]}'
or put this in the mcp.json of your VS Code profile:
{
"servers": {
"amberflip": {
"type": "stdio",
"command": "npx",
"args": ["-y", "amberflip-cli", "mcp"]
}
}
}
Other apps
Any MCP client that starts a local stdio server takes the command npx -y amberflip-cli mcp.
Cline reads llms-install.md. With the Amberflip app installed, Codex and Gemini
CLI are connected from Settings, AI apps as well.
Check it works
Ask your AI app: "Use Amberflip's license_status." It says whether the computer is in the free
trial (and for how long) or has a licence. The server's own instructions tell the AI to pass
absolute paths, call inspect before an edit that needs numbers (a picture's size, a video's
length, a PDF's page count), and call list_operations to see what applies to the files.
Tools
Every tool takes files (absolute paths) and most take output_dir (an absolute folder for the
results; default: the user's setting in the app).
| Group | Tools |
|---|---|
| Find out | list_operations (what can be done with these files), inspect (kind, size, pages, picture size, length, metadata fields), license_status |
| Convert and shrink | convert (to another format by extension), compress (a preset or a target size), run_operation (any operation of list_operations by id, e.g. tool.rotate_cw) |
pdf_pages (reorder, remove, duplicate, turn), pdf_split, pdf_merge, pdf_redact (remove areas for good) | |
| Video | video_trim, video_crop, video_speed, video_split, video_frames, video_join, video_redact, video_resize, video_mute, video_subtitles |
| Audio | audio_trim, audio_normalize, audio_bleep, audio_channels, audio_visualize, audio_fade, audio_bitrate |
| Pictures | image_crop, image_adjust, image_frame, image_collage, image_redact, image_annotate, image_resize |
| Metadata | strip_metadata (remove EXIF, GPS, tags, PDF info), metadata (change or remove single fields) |
| Archives | zip, extract (ZIP, TAR, TAR.GZ) |
amberflip-cli mcp --open-editor adds open_editor, which opens one of the app's editor windows
for you to finish by hand; it needs the Amberflip app.
Skills
The skills folder holds guides that teach an AI app which tool to use for which job. They need Amberflip installed on the same computer.
| Skill | For |
|---|---|
amberflip | Choosing the right tool, and what its errors mean |
amberflip-convert | Converting between formats |
amberflip-compress | Making files smaller, fitting a size limit |
amberflip-strip-metadata | Removing location, camera and author data |
amberflip-pdf | Merging, splitting, reordering and redacting PDFs |
amberflip-video | Trimming, cropping, joining and redacting video |
amberflip-audio | Trimming, loudness, bleeping, waveforms |
amberflip-image | Cropping, adjusting, collages, annotations |
amberflip-recipes | Jobs that take several tools |
The plugin installs them for Claude Code. Without the plugin, the Amberflip app installs them into
~/.claude/skills/ and ~/.agents/skills/ when you press Connect.
Command line
The same engine without a window, for scripts and servers:
npx amberflip-cli convert photo.heic --to jpg
npx amberflip-cli compress talk.mp4 --target 40% --height 720
npx amberflip-cli --help
Install it with npm install -g amberflip-cli. Results always get new names; inputs are never
changed.
Trial and licence
- Free trial: 3 days from first use, on each computer, with every tool.
- After that, a one-time licence key is needed. One key works on one computer that you own or control; the app, the command line, MCP and the skills on that computer are all included. No subscription.
- The price depends on your country and is shown where you buy the key: https://amberflip.com/buy.
- Enter a key yourself, in the app or with
amberflip-cli activate KEY. Never paste a key into a chat with an AI. - When the trial is over, the tools stop with a message that says where to buy a key. Your files are not touched.
- A new key is confirmed once by the licence server (within 7 days of entering it); after that Amberflip works offline.
The full end-user agreement is at https://amberflip.com/legal/.
Privacy
- Your files and their contents never leave your computer. Amberflip has no analytics, telemetry, advertising or crash reporting.
- The only network contact of
amberflip-cliand the MCP server is the licence check: about every six hours when the computer is online, it sends an anonymous one-way hash of the computer's id and, after you enter a key, your licence key, so the free trial and keys cannot be abused. Without internet, Amberflip keeps working with its local checks. - The MCP server listens on no port. It talks to your AI app over standard input and output.
- The AI app you connect sees the paths of your files and the paths of the results, as any tool call shows them. What your AI app sends to its own provider is governed by that app.
Full policy: https://amberflip.com/legal/.
Issues and support
Questions, bugs and requests: open an issue. To contact the developer privately, write to support@amberflip.com. Please do not post licence keys in issues.
What is in this repository
| Path | What |
|---|---|
server.json | Entry for the official MCP Registry (com.amberflip/amberflip) |
glama.json | Ownership file for Glama |
.claude-plugin/, .mcp.json, skills/ | The Claude Code plugin and marketplace |
llms-install.md | Install guide written for Cline |
AGENTS.md | Short guide for coding agents |
CHANGELOG.md | What changed in each version |
Licence of this repository
The manifests, documentation and skills in this repository are under the MIT License.
The Amberflip application and amberflip-cli program are proprietary and are not part of this
repository: see NOTICE.
amberflip-clinpm install amberflip-cli