--log keeps a record of every tool call, so you can see later what an agent did.- MCP server
- aktar v0.6.0
Let your AI agent share files from your own bucket
aktar mcp connects Claude, Cursor, VS Code, Codex and other agents to the Aktar app. Ask for a link and the agent uploads the file to your own S3, Cloudflare R2 or Backblaze B2 bucket, then hands you the URL or Markdown. Your storage keys never leave Aktar.
Then run aktar login once. Cursor, VS Code, Codex and others are below.
Upload the checkout-bug screenshot on my Desktop and give me a Markdown link for the issue.
Called Aktar · upload_file
Uploaded to your Screenshots destination. Here's the Markdown for the issue:
Set up in two steps
Aktar for Mac or Windows does the uploading, so it has to be running on the same computer as your agent.
Install the aktar command and connect it to Aktar. In Aktar, open Settings > Integrations, turn on Allow local connections and copy the token, then paste it into aktar login.
npm install -g @getaktar/cli
aktar loginAdd Aktar to your agent, with the folder it may upload files from after --root (repeat it for more folders). The agent starts aktar mcp by itself when it needs it.
Claude Code
One command, for every project. Change ~/Projects to the folder your work is in. Check with /mcp in Claude Code.
claude mcp add --scope user aktar -- aktar mcp --root ~/ProjectsCodex
One command; it goes into ~/.codex/config.toml.
codex mcp add aktar -- aktar mcp --root ~/ProjectsVS Code
One command adds it to your VS Code profile. Copilot's agent mode then lists Aktar's tools.
code --add-mcp '{"name":"aktar","command":"aktar","args":["mcp","--root","/Users/you/Projects"]}'Cursor
Add this to the file, or to .cursor/mcp.json in one project.
Claude Desktop
Open Settings > Developer > Edit Config, add this, and restart Claude Desktop.
Windsurf
Add this to the file, then refresh the MCP servers in Windsurf's settings.
If an app says it can't find aktar, put the full path from which aktar in command; desktop apps don't always load your shell's PATH. Without a global install, use npx as the command and ["-y", "@getaktar/cli", "mcp", "--root", "/Users/you/Projects"] as the arguments. Replace /Users/you/Projects with your own folder (on Windows, like C:\\Users\\you\\Projects). Without --root, files come only from the folder the agent starts the server in, and none at all when that's your home folder or the top of the disk, as it often is for desktop apps. Any other agent that runs MCP servers over stdio works the same way.
What you can ask
Say it the way you'd say it to a colleague. The agent picks the tool, Aktar does the upload with the destination's own settings, and you get the link in the conversation.
Share a file from a session
“Zip the build and give me a link I can send to QA.”
The agent makes the file and uploads it. Without a destination named, Aktar picks one by file type (each destination's Use For), like a drop on the menu bar.
Tools:
upload_fileImages for a README or an issue
“Add the new screenshot in docs/images to the README.”
It uploads the image and writes the Markdown where it belongs. WebP conversion and location removal happen in Aktar, as the destination says.
Tools:
upload_fileUpdate a file, keep its link
“Replace the onboarding PDF I shared last week with this new version.”
It finds the upload in history and writes the new file over it. Everyone who has the link sees the new version; nothing needs to be sent again. Replacing overwrites the old file, so it needs
--allow-replace.Tools:
search_uploadsreplace_fileFind what you uploaded
“What was the link to the invoice I uploaded on Monday?”
It searches Aktar's history by name and date, and can look at thumbnails to tell screenshots, photos and documents apart.
Tools:
search_uploadsget_thumbnailA link that expires
“Give me a 30-minute link to the contract in the Legal bucket.”
A presigned link to any file in a bucket, for private buckets or sharing for a limited time. Nothing in the bucket changes.
Tools:
create_temporary_linkLook around your buckets
“What's in the releases folder of my Builds bucket?”
It lists folders and files, including ones not uploaded with Aktar, and knows which destination is used for which file types.
Tools:
list_bucketlist_destinations
Step by step for your AI tool
A ready-made plugin or a config you can copy, with what to ask once it's set up.
Claude Code
Step-by-step guideCursor
Step-by-step guideGemini CLI
Step-by-step guideCline
Step-by-step guide
Listed on:Official MCP RegistryGlamamcpservers.org
Tools your agent gets
Searching, listing, temporary links and thumbnails only look. Uploading changes your bucket, and your agent asks before using it unless you allow it. Replacing and deleting are only offered when you turn them on.
| Tool | What it does |
|---|---|
| upload_ | Uploads a file and returns its link, Markdown and HTML. Destination, name, folder and expiry are optional. short asks for a short link, or for none. |
| upload_ | Uploads the file or image on the clipboard. short asks for a short link, or for none. Left out when --root is given. |
| replace_ | Writes a new file over an upload or any file in a bucket, keeping its link. Only with --allow-replace or --allow-delete. Needs Aktar for Mac 0.14.0 or Windows 0.7.0. |
| create_ | Makes a short link for an upload with its destination's link shortener, or returns the one it has. Left out with --read-only. Needs Aktar for Mac 0.17.0 or Windows 0.10.0. |
| search_ | Searches the upload history. |
| list_ | Lists destinations and the file types each one is used for. |
| list_ | Lists a bucket's folders and files, including files not uploaded with Aktar. |
| create_ | Makes a link that stops working after a while (a presigned URL). Anyone with it can download the file until then, even from a private bucket. At most 60 minutes unless --max-link-minutes allows more. |
| get_ | Shows the agent a preview of an upload. Needs Aktar for Mac 0.13.0 or Windows 0.6.0. |
| list_ | Lists watched folders and their status. |
| get_ | Checks the connection to Aktar. |
| delete_ | Deletes an upload from its bucket. Only with --allow-delete. |
You decide what it can touch
An upload is public to anyone with the link, so the server starts with little and you decide what to add.
Uploading is publishing
The agent is told to upload only what you asked to share, and agents ask before calling a tool that uploads.Only from your folders, never secrets
Files come only from the folders you name with--root, or the folder the agent starts the server in, never your whole home folder by accident. SSH and private keys,.envfiles, cloud credentials, browser profiles and password databases are refused wherever they are, symlinks included.Nothing overwritten unless you say so
Replacing a file is only offered with--allow-replace, and deleting with--allow-delete.--read-onlyleaves out every tool that writes. Temporary links last at most 60 minutes unless--max-link-minutesallows more.Your keys stay in Aktar
The server talks to Aktar on 127.0.0.1, and checks it's really Aktar before sending your token. The agent never sees your access keys, and nothing goes through a server of ours.
No MCP? Use the skill
For agents that use skills but not MCP, aktar skill prints a SKILL.md that teaches them the aktar command: what to run, how to read --json, and to upload only what you asked. Every command is in the CLI docs.
mkdir -p ~/.claude/skills/aktar
aktar skill > ~/.claude/skills/aktar/SKILL.mdRequirements
- Aktar for Mac or Windows, running, with at least one destination
-
The
aktarcommand 0.4.0 or later (Node.js 18 or later). aktar 0.6.0 and later need Aktar for Mac 0.18.0 or Windows 0.11.0 - An agent that runs MCP servers over stdio
- Replacing files: Aktar for Mac 0.14.0 or Windows 0.7.0. Thumbnails: Mac 0.13.0 or Windows 0.6.0
- Open source (MIT) on GitHub, listed in the official MCP Registry
Questions
Does it work with ChatGPT or other agents in the browser?
Can the agent upload files I didn't ask for?
--root (or the folder the agent starts it in), and secrets such as SSH keys and .env files are never uploaded. --read-only turns uploading off, and --log shows you afterwards what was called.Which bucket does it upload to?
Does it cost anything?
Does it work on Windows?
aktar command works with Aktar for Windows the same way, and so does every agent above.Integrations
Where you already work.
- Aktar for RaycastUpload the clipboard or selected files, search your history with thumbnails and browse your buckets. Ask Raycast AI for a 2-hour link to a file.Commands and setup
- The aktar commandUpload from scripts, CI jobs and Typora, and get back a URL, Markdown or JSON.Install and commands
- Your bucket, inside ObsidianPaste, drop or move attachments into your own bucket. Keys stay on the device.How the plugin works
