mcpbeat Sign in

Aiko MCP Server

by masa-san-jp Your server? Claim it
local only

Aiko runs on your own machine — the client starts it, so there is no endpoint to ping. 37 installs a week from npm. Last commit 3 Aug 2026.

A portable persona for MCP clients — the same agent in Claude Code, Codex, Cursor and VS Code

Installs per day peak 13 · avg 6 · -56% w/w
a month agotoday
37
Installs / week
npm · aiko-mcp
3
Stars
3 open issues
3 Aug 2026
Last commit
0 releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 1 h ago · rules 3dff92dd89df

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add aiko -- npx -y aiko-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "aiko": {
      "args": [
        "-y",
        "aiko-mcp"
      ],
      "command": "npx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.aiko]
command = "npx"
args = ["-y", "aiko-mcp"]
.cursor/mcp.json
{
  "mcpServers": {
    "aiko": {
      "args": [
        "-y",
        "aiko-mcp"
      ],
      "command": "npx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "aiko": {
      "args": [
        "-y",
        "aiko-mcp"
      ],
      "command": "npx"
    }
  }
}

This one needs environment variables set before it will start: AIKO_HOME (Where personas and user context live. Defaults to ~/.aiko), AIKO_PERSONA_ID (Which persona to load. Defaults to aiko), AIKO_USER_PROFILE (Path to a User Profile JSON file). The author declared them in the registry entry; get the values from the project itself.

Alternatives to Aiko

same job, measured the same way
Warp Ozbridge
by sena-labs

OzBridge: run Warp Oz agents from any MCP client — Claude Code, Cursor, Codex, VS Code.

38 installs/wk local only
Apuchat
by opcastil11

Real-time chat for AI agents. Claude Code, Cursor, Cline and Codex join channels over MCP.

18 tools answering
Karea MCP
by starecz

Karea task manager - 49 tools for Claude Code, Cursor, and other MCP clients.

512 installs/wk local only
Pathmark
by hacksurvivor

Local-first intent and provenance for Codex, Claude Code, Cursor, Gemini CLI, and MCP agents.

64 installs/wk local only
Pathrule
by pathrule

Path-scoped team memories, rules and skills for Claude Code, Cursor, Codex and other MCP clients.

32 tools answering
Agent MCP Hub
by blackaxgit

One MCP server bridging the Codex, Cursor, OpenCode, Claude, and Antigravity CLI agents

48 installs/wk local only
Travel Assistant MCP
by forgemeshlabs

No-key travel MCP for Claude Desktop, Codex-style agents, Hermes, and other clients.

68 installs/wk local only
Foxhound
by caleb-love

MCP server for querying Foxhound traces from Claude Code, Cursor, and other MCP clients

21 installs/wk local only

Aiko — questions

Answers built from our own checks of this server.

Why is there no uptime for Aiko?
Aiko runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package aiko-mcp was installed 37 times last week.
How do I connect Aiko?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls aiko-mcp straight from npm; nothing to host, nothing to sign up for.
How many people use Aiko?
The npm package aiko-mcp was installed 37 times in the last week. Week over week that is -56%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Aiko open source?
Yes — it is published under the MIT licence, written in TypeScript, 3 stars on GitHub and 3 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.