Note-Taking · AI Chatbot

Ainote MCP

ainote-dev/ainote-mcp

A Model Context Protocol (MCP) server that connects AI assistants to your AI Note task management system. This package enables direct interaction with your AI Note tasks through natural language conversations in Claude Desktop and other MCP-compatible platforms.

Install

npx -y @ainote/mcp

Client configuration

{
  "mcpServers": {
    "ainote": {
      "command": "npx",
      "args": [
        "-y",
        "@ainote/mcp"
      ]
    }
  }
}

Environment variables

AINOTE_API_KEY
Category
Note-Taking, AI Chatbot
License
MIT
Updated
Oct 6, 2026

Features

  • Task Management: Create, update, delete, and list tasks directly from Claude Desktop

  • Dev Docs: Manage CLAUDE.md, Cursor rules, Windsurf rules, and dev documents centrally via MCP

  • Dev Category Hierarchy: Auto-organized under dev/ with subcategories (claude, cursor, windsurf, copilot, docs, skills, agents, commands, hooks, mcp)

  • Claude Environment Sync: Push/pull ~/.claude/ skills, agents, commands, hooks across machines (macOS/WSL/Linux)

  • End-to-End Encryption: mcp category (mcpServers + API keys) auto-encrypted client-side with age; server never sees plaintext

  • OS Keychain Integration: Per-machine age identity stored in macOS Keychain / libsecret / Credential Manager (file fallback supported)

  • Session Handoffs: handoff_save / handoff_list / handoff_get with optional time: HHMM for same-day disambiguation — saved under the primary vault, auto-purged after 7 days

  • Multi-Device File Sync: sync_push / sync_pull / sync_list push markdown notes into the user's git-backed primary vault — works across macOS, Linux, iOS shortcuts

  • MCP Tool Annotations: Every tool advertises readOnlyHint / destructiveHint / idempotentHint / openWorldHint so autonomous agent runtimes can gate destructive calls

Tools (29)

  • signup_and_get_key

    Create account + get MCP key

  • login_and_get_key

    Login + get MCP key (existing account)

  • get_setup_guide

    Setup instructions

  • Protocol

    Server-Sent Events (SSE)

  • Usage

    Bulk operations, large task lists, real-time progress

  • tasks/list

    Stream task list with filters

  • tasks/create

    Create single task with progress

  • tasks/analyze

    Get task statistics and insights

  • tasks/bulk_update

    Update multiple tasks with progress

  • tasks/bulk_create

    Create up to 1000 tasks at once

  • list_tasks

    List tasks from AI Note with advanced filtering options.

  • create_task

    Create a new task in AI Note.

  • update_task

    Update an existing task.

  • delete_task

    Soft delete a task.

  • list_categories

    List all available categories.

  • list_dev_docs

    List dev documents with optional filtering.

  • get_dev_doc

    Get a single dev document by title or id.

  • create_dev_doc

    Create a new dev document under dev/ category.

  • update_dev_doc

    Update a dev document with replace, append, or prepend modes.

  • delete_dev_doc

    Soft delete a dev document.

  • list_dev_categories

    List all subcategories under dev/ with document counts.

  • handoff_save

    Write a handoff (project, topic, content, optional date, optional time HHMM for same-day disambiguation)

  • handoff_list

    Most-recent-first list, optionally filtered by project.

  • handoff_get

    Fetch by project + topic (+ optional date/time).

  • sync_push

    Push a markdown note (path + content) into the vault repo

  • sync_pull

    Read a markdown note from the vault by path

  • sync_list

    Enumerate vault paths (optionally filtered)

  • vault_sync

    Unified wrapper around the above three

  • GitHub

    Backed Vaults

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Claude Desktop logo

Claude Desktop

Desktop · Freemium · Proprietary

Anthropic's official Claude AI desktop application. Supports MCP servers to extend functionality.

WindowsMacOS
Cursor logo

Cursor

Desktop · Freemium · Proprietary

The first agentic IDE. The Cursor editor truly merges how developers and AI work together, delivering a magical coding experience.

WindowsMacOSLinux
Windsurf logo

Windsurf

Desktop · Freemium · Proprietary

The first agentic IDE. The Windsurf editor truly merges how developers and AI work together.

WindowsMacOSLinux

Related MCP servers

More servers
Notion MCP Server (Official) logo

Notion MCP Server (Official)

makenotion/notion-mcp-server

1.5k

For the best experience, use Remote Notion MCP, our official hosted MCP server. This repository is a separate, self-hosted MCP server implementation that is no longer actively maintained or supported. Please use Remote Notion MCP instead.

Note-Taking
MCP Obsidian logo

MCP Obsidian

MarkusPfundstein/mcp-obsidian

750

MCP server to interact with Obsidian via the Local REST API community plugin.

Note-Taking
MCP Notion Server logo

MCP Notion Server

suekou/mcp-notion-server

671

This server targets the Notion API 2026-03-11 and uses the current database/data source model. It exposes MCP tools, prompts, resources, structured tool results, and optional MCP Apps for interactive Notion workflows.

Note-Taking
Obsidian MCP logo

Obsidian MCP

StevenStavrakis/obsidian-mcp

261

A local Model Context Protocol server that lets MCP-compatible assistants safely read and modify explicitly configured Obsidian vaults.

Note-Taking
MCP Apple Notes logo

MCP Apple Notes

RafalWilinski/mcp-apple-notes

187

A Model Context Protocol (MCP) server that enables semantic search and RAG (Retrieval Augmented Generation) over your Apple Notes. This allows AI assistants like Claude to search and reference your Apple Notes during conversations.

Note-Taking
notion_mcp logo

notion_mcp

danhilse/notion_mcp

171

A simple Model Context Protocol (MCP) server that integrates with Notion's API to manage my personal todo list through Claude. This is a basic implementation tailored specifically for my minimalist todo list setup in Notion.

Note-Taking