Ainote MCP Server

by seunghan91io.github.seunghan91/ainotev1.3.2

MCP server for AI Note - Tasks, Dev Docs, and multi-device file sync (CLAUDE.md, memory files, Cursor rules, Windsurf rules)

Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Slowing5mo ago

Install Ainote MCP server

claude mcp add ainote -e AINOTE_API_KEY='<ainote-api-key>' -- npx -y @ainote/mcp

{
  "mcpServers": {
    "ainote": {
      "command": "npx",
      "args": [
        "-y",
        "@ainote/mcp"
      ],
      "env": {
        "AINOTE_API_KEY": "<ainote-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "ainote": {
      "command": "npx",
      "args": [
        "-y",
        "@ainote/mcp"
      ],
      "env": {
        "AINOTE_API_KEY": "<ainote-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "ainote": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ainote/mcp"
      ],
      "env": {
        "AINOTE_API_KEY": "<ainote-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "ainote": {
      "command": "npx",
      "args": [
        "-y",
        "@ainote/mcp"
      ],
      "env": {
        "AINOTE_API_KEY": "<ainote-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
AINOTE_API_KEY	yes	yes	64-character ainote MCP key. Issue one via `npx @ainote/mcp signup` (RFC 8628 device flow), or in a Claude session by calling signup_and_get_key, or at https://app.ainote.dev -> Settings -> MCP keys.

Remote endpoints

streamable-httphttps://api.ainote.dev/api/mcp

Freshness

Slowing — last maintenance signal 5mo ago. The newest of the signals below sets the band.

Last commit (default branch)
no data · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-05-14 · 5mo ago · official registry · v1.3.2

FAQ

›How do I install the Ainote MCP server in Claude Code?

Run: claude mcp add ainote -e AINOTE_API_KEY='<ainote-api-key>' -- npx -y @ainote/mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Ainote require an API key?

Yes. It expects AINOTE_API_KEY, of which 1 is a secret.

›Can I use Ainote as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Ainote in the official MCP registry?

Yes, as io.github.seunghan91/ainote.