Aktar for Cursor

Upload files to your own bucket from Cursor

Add Aktar to Cursor and its agent can upload images and files to your own S3, Cloudflare R2 or Backblaze B2 bucket, make temporary links and look inside your buckets. It runs next to the Aktar app on your computer, so your storage keys never leave Aktar.

Upload public/og-image.png and use its URL in the og:image meta tag.

Called Aktarupload_file{ "path": "public/og-image.png" }

Uploaded. I've put this URL in the og:image tag:

https://files.example.com/2026/11/og-image.png

What you can ask

  • Images for docs and changelogs

    “Upload the screenshots in docs/ and link them in CHANGELOG.md.”

    The agent uploads each image and writes the links where they belong. Aktar converts and cleans images as the destination says.

    Tools: upload_file

  • A link that expires

    “Give me a 30-minute link to backup.sql in my Builds bucket.”

    A presigned link to any file in a bucket, for private buckets or sharing for a limited time. Nothing in the bucket changes, and links last at most 60 minutes unless you allow more.

    Tools: create_temporary_link

  • Look inside a bucket

    “What's in the releases folder of my Downloads bucket?”

    It lists folders and files, including ones not uploaded with Aktar.

    Tools: list_bucket

Set it up

  1. 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
  2. In your project, create .cursor/mcp.json with this. ${workspaceFolder} is the project folder, so Aktar uploads files from that project only.

    In .cursor/mcp.json
    {
      "mcpServers": {
        "aktar": {
          "command": "npx",
          "args": ["-y", "@getaktar/cli", "mcp", "--root", "${workspaceFolder}"]
        }
      }
    }
  3. Open Cursor's settings, find aktar in the MCP list and check that it's turned on. The agent then sees Aktar's tools.

To use Aktar in every project, put the same thing in ~/.cursor/mcp.json with a folder in place of ${workspaceFolder}, like /Users/you/Projects (on Windows, C:\\Users\\you\\Projects). Repeat --root and a folder to allow more.

Because the folder is given with --root, uploading straight from the clipboard is left out; point the agent to a file instead. Add --allow-replace or --allow-delete to the arguments to let it replace or delete uploads. If Cursor can't start npx, put its full path from which npx in command.

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 RegistryGlamamcpservers.org

Questions

Does Cursor get my storage keys?

No. Your keys stay in the Aktar app. The server 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.

Does the agent ask before uploading?

Cursor asks before it runs an MCP tool unless you've turned on auto-run for it. Searching, listing and temporary links only look; uploading changes your bucket.

Can I use it in every project at once?

Yes. Put the config in ~/.cursor/mcp.json instead, with the folders it may upload from after --root.

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.

Other AI tools