Aktar for Gemini CLI

Upload files to your own bucket from Gemini CLI

The Aktar extension lets Gemini CLI upload files and screenshots to your own S3, Cloudflare R2 or Backblaze B2 bucket, turn what's on your clipboard into a link and find what you uploaded before. It runs next to the Aktar app on your computer, so your storage keys never leave Aktar.

Set it up getaktar/agent-pluginsv0.6.0

Upload dist/report.pdf and give me a link for the team.

Called Aktarupload_file{ "path": "dist/report.pdf" }

Uploaded. Here's the link:

https://files.example.com/2026/11/report.pdf

What you can ask

Share a file
“Upload dist/report.pdf and give me the link.”
Gemini uploads the file from your project. Without a destination named, Aktar picks one by file type, like a drop on the menu bar.
Tools: upload_file
Upload what you copied
“Upload the screenshot on my clipboard.”
Aktar uploads the image or file you copied and the link comes back in the conversation.
Tools: upload_clipboard
Short links
“Make a short link for the release notes I uploaded yesterday.”
It finds the upload and asks Aktar for a short link from the shortener you set up for that destination.
Tools: search_uploads, create_short_link

Set it up

Install Aktar for Mac or Windows and add a destination (your bucket). In Aktar, open Settings > Integrations, turn on Allow local connections and copy the token, then paste it into this command. It needs Node.js 18 or later.
```
$ npx @getaktar/cli login
```

Install the extension in a terminal.

$ gemini extensions install https://github.com/getaktar/agent-plugins

Start gemini in your project folder and trust the folder when it asks: Gemini CLI doesn't start MCP servers in folders you haven't trusted. Run /mcp to see Aktar's tools.

The extension runs a fixed version of @getaktar/cli with npx, so you don't need to install the aktar command. Update it with gemini extensions update aktar.

It uploads only from the folder Gemini CLI runs in. Started in your home folder, it uploads no local files at all, so start it in a project folder.

What it can touch

Files come only from the folders the server may use, and secrets such as SSH keys, .env files and cloud credentials are never uploaded. Replacing and deleting uploads are off unless you turn them on. Your storage keys stay in Aktar: the agent gets file names and links back, and nothing goes to us. An upload is public to anyone with its link, so ask only for what you want to share.

Details are in the privacy policy. Every tool and option is on the MCP server page.

Listed on:Official MCP Registry Glama mcpservers.org

Questions

Does the extension get my storage keys?

No. Your keys stay in the Aktar app. The extension only uses the local token that npx @getaktar/cli login saves in a file only you can read, and it talks to Aktar on 127.0.0.1.

Why doesn't Gemini see Aktar's tools?

Usually because the folder isn't trusted: Gemini CLI doesn't connect to MCP servers in untrusted folders. Run gemini trust in the folder, or trust it when Gemini asks, then check with /mcp.

Does Gemini ask before uploading?

Yes, unless you've allowed the tool or started Gemini CLI in YOLO mode. Searching and listing only look; uploading changes your bucket.

Does it work on Windows?

Yes, with Aktar for Windows 0.11.0 or later. On a Mac you need Aktar for Mac 0.18.0 or later.