What is it

What is Aki MCP Server?

Aki MCP Server is a free, open-source program you install on your own computer so AI apps such as Claude, ChatGPT or Cursor can work with your files, commands and browser, only inside the folders and commands you allow. AI apps on this computer connect directly; letting web AI apps reach it is optional.

What is each piece?

Your AI app

Claude, ChatGPT, Cursor or another app where you type the request.

Aki MCP Server

The program on your computer that receives the request, checks it and runs the tool.

Control panel

A page only you can open, at 127.0.0.1:9998, where you set folders and commands and copy each app’s settings.

Your computer

Your files, terminal and browser. Tools touch only the parts you allowed.

MCP in one sentence

MCP (Model Context Protocol) is an open standard that lets an AI assistant call real tools (read a file, run a command, drive a browser) instead of only generating text. Aki MCP Server is one such tool server, running on your machine.

Why it exists

Most real work with AI is project work: reading, editing and running things on your computer. Aki MCP Server lets the AI app you already use do that work directly, instead of you copying files and errors back and forth.

Use the chat plan you already pay for, not per-token API billing

Claude Pro or ChatGPT Plus is a flat monthly plan: reading a whole codebase or tailing logs through it adds no per-token bill. Aki MCP Server points that plan at the source code on your machine.

Several accounts, one machine

Just switch browser profiles: several Claude Pro accounts, all pointed at the same machine.

Control your machine away from your desk

On the move or on another device: open Claude Web, ChatGPT Mobile or Grok to check a build’s progress, read server logs, clean up temp files, or see what changed in the code on your machine at home.

Jobs that run on a schedule, with nobody watching

Pair Grok’s scheduled prompts with Aki MCP Server and your computer keeps working while you are away. At the set time, Grok calls in to check the system, sweep logs, drive a real browser tab or report what changed in the code, with no window open on your side.

What it does

One install gives your AI 38 tools in eight groups:

Files and search

Read, write, and edit files inside the folders you allow, plus whole-tree path and content search.

Allowed commands

Run only the commands on your allowlist. The default list is for looking, not changing, and long output is trimmed to fit what the AI can read in one chat.

Browser and DevTools

Open a shared Chrome profile that keeps your logins, or attach to a Chrome you already run; then click, type, take screenshots and debug pages with DevTools.

Git and SQLite

One compact, read-only git tool (status, diff, log, tags) and SQLite schema reads and queries that can only read (SELECT, WITH, EXPLAIN, PRAGMA, VALUES).

Jobs, ports and local services

Start long-running jobs and read their logs, check or free a port, and call the web servers and APIs running on your computer.

Postman control

Drive the Postman desktop app: inspect and send requests, read tests, and more.

AIObox windows

With the optional AIObox desktop app, read and act on its AI windows.

Clipboard and notifications

Read or fill your clipboard, and get a desktop notification when a long task finishes.

Tools that need an app you have not installed are hidden; the panel’s “Tool providers” section turns each group on or off.

How it works

Every request takes the same four steps; only the way in differs.

  1. 1You ask your AI app for something, such as “read the spec in my project”.
  2. 2The app sends the call to your computer. AI apps on this computer connect directly to 127.0.0.1 (loopback) or start the tools themselves (stdio). Web AI apps come in through an optional public address (ingress), Tailscale Funnel by default.
  3. 3The gatekeeper checks the call: a web AI app signed in once with your passphrase (OAuth 2.1), a local app sends its access token, and an app started over stdio needs no token.
  4. 4The tool runs only inside your allowed folders and allowlisted commands, and the result goes back to the AI.

Who it is for

  • People who work in an AI app every day and keep copying files and errors between the chat and their computer.
  • Developers who want the AI to read, edit and run code and tests on their own machine.
  • AI power users running several accounts across web AI apps.
  • Anyone who needs to reach their computer from a phone or a borrowed browser.

When to use it, and when not

Use it away from your desk

On mobile, on the web, or on a machine that is not yours: check a job, read logs, or see what changed in your code.

At your desk, a native CLI wins

A terminal-based coding agent is faster and more fluid when you are sitting at the machine.

Words you will meet

Each term, in one plain sentence. The same words appear in the control panel and in your AI app.

MCP

MCP (Model Context Protocol) is an open standard that lets an AI app call real tools on a computer, such as reading a file or running a command, instead of only writing text.

Aki MCP Server

Aki MCP Server is a free, open-source program you install on your own computer; it gives AI apps 38 tools that work only inside the folders and commands you allow.

Tool

A tool is one action the AI can ask your computer to do, such as read a file, search a folder or open a web page.

Control panel

The control panel is a page on your own computer (http://127.0.0.1:9998) that opens when the server starts; there you choose folders and allowed commands and copy the settings each AI app needs.

Connector

A connector is the entry you add inside an AI app (Claude, ChatGPT, ClickUp and others) that points it at your server.

Display name, Server ID, Tool prefix

The Display name is the name AI apps list your server as (AkiMCP by default), the Server ID is the key app settings store it under (akimcp), and the Tool prefix goes in front of every tool name (aki__run_cmd); all three are set at the top of the panel’s “Connectors” section.

MCP URL

The MCP URL is the web address an AI app uses to reach your server; the panel shows it ready to copy.

Passphrase

The passphrase is a secret phrase the panel shows; you type it once on the confirmation page when a web AI app connects, so only you can approve it.

Access token

The access token is a long secret key that apps on this computer (Cursor, Claude Code, Codex, Postman) and Buda send with every call; the panel holds it and can replace it if it leaks.

Ingress (public address)

An ingress is an optional public HTTPS address that lets AI apps on the web reach your computer; Tailscale Funnel is the default, Cloudflare Tunnel or your own domain also work. Apps on the same computer never need it.

Tailscale Funnel

Tailscale Funnel is a Tailscale feature that gives your computer a public HTTPS address; it needs a free Tailscale account, and the server turns it on for you.

Loopback (127.0.0.1)

127.0.0.1 (loopback) is the address a computer uses to talk to itself; apps on the same computer connect there with no internet path.

stdio

stdio is a way for an app on the same computer to start the tools itself and talk to them directly, with no network and no token; the Claude app and AGY connect this way.

Gatekeeper

The gatekeeper is the part of the server that receives every call, checks its passphrase sign-in or token, and only then passes it to the tools.

OAuth 2.1

OAuth 2.1 is the standard sign-in handshake web AI apps use to ask for access; with AkiMCP it ends on the page where you type your passphrase.

Allowed folders

Allowed folders are the only folders the tools may read and change; by default this is your whole home folder, and the panel’s “Folders the connector may reach” section adds or removes folders.

Shell allowlist

The shell allowlist is the list of commands the AI may run; any command not on it is refused. The panel’s “Allowed shell commands” section edits it.

Tool providers

Tool providers are groups of tools that need a certain app (Postman, Chrome, AIObox, agy, Kiro CLI); tools of an app you have not installed are hidden, and the panel’s “Tool providers” section turns each group on or off.

AIObox

AIObox is an optional desktop app that adds shared Chrome profiles and AI windows the tools can drive. It is free during the closed beta, for AkiDev members; the panel’s “AIObox” section says how to get it.

Session file

A session file is one notes file per chat, at a path AkiMCP creates, so the AI keeps writing its progress to the same place.

AkiDevRule

AkiDevRule is an optional rule set, open on GitHub, that tells the AI how to work in your projects; the panel’s “Install AkiDevRule (optional)” section installs it, and any AI app that loads its rules through AkiMCP gets them.