Aki MCP Server v4.2.0·Free, open source (MIT)

Let the AI you already use work on your own computer

AkiMCP is a free, open-source MCP server (MCP is the standard AI apps use to call tools) that runs on your computer. Web AI apps and apps on this computer get the same tools for your files, terminal and browser, only in the folders and commands you allow.

1 · Your AI app

  • Claude web
  • ChatGPT
  • Grok
  • Notion
  • ClickUp
  • Buda
  • Gemini· experimental
  • Postman
  • Cursor
  • Claude Code
  • Claude app
  • AGY (Antigravity)
  • Codex

+12 more apps

“Find last week’s meeting notes”

2 · AkiMCP checks your limits

AkiMCP on your computer

Inside a folder you allowedSee it in the panel: Folders the connector may reach
aki__find_path

3 · Your computer does the work

  • Files4 notes found in Documents/Meetings
  • Terminal
  • Browser

What it does for you

Stop being the clipboard between your AI and your computer

Without it you copy a file, paste an error, copy again. With it you ask once, for everyday work or developer work. Each grey line is one AkiMCP tool call, shown in the chat as it happens.

Everyday work

Claude web
  1. You: Find my notes from last week in Documents and write a one-page summary next to them.
  2. aki__find_path 4 notes in Documents/Meetings
  3. aki__read_text_file Read 4 notes
  4. aki__write_file Wrote Documents/Meetings/summary.md
  5. You: Now put the PDFs in Downloads into a Receipts folder.
  6. aki__create_directory Created Downloads/Receipts
  7. aki__move_file Moved 6 PDFs
  8. AI: Done. The summary sits next to your notes, and the 6 PDFs are in Downloads/Receipts.

Developer work

ChatGPT
  1. You: The login test fails. Find out why, fix it and run the tests again.
  2. aki__run_cmd npm test: 2 of 48 failed in auth.test.js
  3. aki__search_content expiresAt found in src/auth.js:42
  4. aki__edit_file Edited src/auth.js: compare seconds with seconds
  5. aki__run_cmd npm test: 48 of 48 passed
  6. aki__git op=diff: 1 file, 1 line changed
  7. AI: Fixed: the expiry check compared seconds with milliseconds. All 48 tests pass; the diff is one line in src/auth.js.

Get started

Start in three steps

One command to install, a panel that opens by itself, then one setting in your AI app.

  1. 1Install and start AkiMCP

    Paste these two lines in a terminal on macOS, Windows or Linux. No sudo and no background service: closing the terminal stops AkiMCP.

    npm install -g @akinet/akimcp
    akimcp

    Needs Node.js 22 or newer; on Windows also Git for Windows. To try it without installing: npx @akinet/akimcp

  2. 2The panel opens by itself

    The control panel runs on this computer only, at 127.0.0.1:9998 by default. It holds the passphrase, the access token and a setup tab for each app.

  3. 3Add AkiMCP in your AI app

    Copy the values from that app’s tab in the panel’s Connectors section. Apps on this computer connect directly. The panel’s Setup steps then end with a one-time instruction to paste into your AI.

    A web AI app needs a public address: Tailscale Funnel (free, no domain) or a Cloudflare tunnel. Most then sign in with the passphrase.

Needs Node.js 22 or newer and one terminal command. No sudo, and closing the terminal stops it. Free, MIT, no AkiMCP account. Web AI apps also need a public address: free Tailscale Funnel, a Cloudflare tunnel or your own HTTPS origin.

What stays yours

You decide what the AI can reach

Every limit lives in the control panel on your computer. Each card names its panel section.

  • A passphrase for every web AI app

    A web AI app gets in only after you type the passphrase. Wrong credentials are blocked: 5 in 60 seconds, then 15 minutes. The limits are yours to edit.

    See it in the panel: Security & connection limits
  • Only the folders you list

    By default: your whole home folder, plus ~/.aki and ~/.claude. Narrow home to your projects here; it applies at once. The ~/.claude row is locked (it holds session tokens and chat history); to drop it, edit ~/.aki/mcpsv/setting.json.

    See it in the panel: Folders the connector may reach
  • Only allowlisted commands

    The terminal runs a command only if it is on the list. An unknown command is refused, and so are chains such as ; | &. It keeps a careless or overeager AI in line; it is not a wall against someone who holds your token. Commands you add are your call.

    See it in the panel: Allowed shell commands
  • Calls over HTTP logged by default, never your text

    The call log records which AI app used which tool, when, and whether it worked, never the text, script or URL you sent. The security log shows refused sign-ins. Apps that start AkiMCP over stdio are not logged.

    See it in the panel: Logs
  • See every app that got in, cut off any one

    The Clients table lists each app that connected: first seen, last sign-in, address and agent, and Active now shows who is calling. Remove only forgets one app (its current token works until you roll it); Revoke & roll removes it and replaces the shared token at once.

    See it in the panel: Security & connection limits
  • Roll the token if it leaks

    Roll token replaces the shared access token: pasted copies stop working. Most web AI apps refresh on their own, ClickUp needs one reconnect, and Cursor, Claude Code and Codex need Apply again in the panel (or the new token pasted, on another computer). Claude app and AGY run over stdio with no token, so a roll does not touch them.

    See it in the panel: Connectors

Where next

Pick the next step that fits you

Three common questions after a first look, each answered by one page.

  • Ready to start?

    Install with one command, open the panel, then add AkiMCP to your AI app.

    Start in 3 steps
  • Not sure what this is yet?

    MCP explained on one page: the parts, why it exists, and all 38 tools.

    What is AkiMCP?
  • Worried about safety?

    Exactly what the AI can touch, what stops a bad command, and what is logged.

    How the security model works

Support

Donate me a coffee

Aki MCP Server is free and open source. If it saved you time, a coffee keeps it going.