io.github.seunghan91/ainote

up checked 2026-11-11T05:38:17.027Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided description

Agent-native notes, tasks, dev-docs, vaults, sync & handoffs. MCP + OpenAPI dual surface.

Summary by lookupd

Lets agents read, write and sync notes, tasks, dev docs and encrypted env secrets across devices, with human judgment requests for…

Install

Claude Code, remote (streamable-http)

claude mcp add --transport http ainote https://api.ainote.dev/api/mcp

Claude Code, npm package (stdio)

claude mcp add ainote -- npx -y @ainote/mcp

Codex, remote (streamable-http)

codex mcp add ainote --url https://api.ainote.dev/api/mcp

Codex, npm package (stdio)

codex mcp add ainote -- npx -y @ainote/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

{
  "mcpServers": {
    "ainote": {
      "url": "https://api.ainote.dev/api/mcp"
    }
  }
}

Cursor, npm package (stdio) → .cursor/mcp.json

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

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (showing 30 of 35)

Publisher-provided text

• delete_task Soft-delete a task by ID. Destructive but reversible within 30 days (TaskCleanupJob purges trash daily at 2am KST). Returns 404 if the task does not exist or is
• list_papers List notes/papers from AI Note. Supports keyword search across title and content, category filtering, pagination, and sorting. Returns id/title/content_preview/
• project_read List the authenticated user's projects (L2 intent layer), or fetch one by id. Each entry includes riskiest_assumption — the single highest-priority unverified a
• project_write Create or update a project (L2 intent layer). Omit `id` to create, pass it to update. There is no delete tool — use status: 'archived' to retire a project.
• assumption_write Create or update an assumption under a project (L2 intent layer). Omit `id` to create, pass it to update. There is no delete tool. 🔴 `verdict` is REJECTED wit
• judgment_submit Request a human judgment (L3 layer) by attaching evidence — approval, evidence, or verdict. This is the ONLY door an agent has into the judgment queue. 🔴 `dec
• judgment_list List the authenticated user's own judgments (L3 layer) — use this to check your own blocking status (risk_tier 1 pending = execution blocked). Default order mat
• delete_dev_doc Soft-delete a dev document by title or UUID. Reversible from trash. Pass `category` when multiple docs share the same title across subcategories (memory/claude/
• get_setup_guide Get instructions for setting up AI Note MCP in Claude Desktop, Cursor, or other MCP clients. No authentication required.
• vault_create Create a new private vault as a GitHub repository under the user's account. Requires the user to have completed the GitHub App install flow first.
• vault_sync Wrapper around vault file sync. action=list|pull|push to work against the primary vault. list/pull are paginated — narrow with `path`/`since` and follow `next_c
• sync_push Push a markdown file into the primary vault. Optional CAS via base_sha to detect concurrent multi-PC writes (Layer 3 of multi-PC sync plan). WAF-bypass tip: lar
• sync_push_batch Push MANY files into the primary vault in ONE call. Use this instead of looping sync_push whenever you have more than a couple of changed paths — the cost of sy
• sync_changes Read changes from the primary vault in sequence order, including deletions. Start with since_seq=0 for a full listing; then pass next_seq and feed_epoch on each
• sync_delete Delete a file from the primary vault. Optional CAS via base_sha to detect concurrent multi-PC writes. Protected paths (global/memory/, global/skills/, global/pl
• sync_audit_layer5 Record the result of a client-side Layer 5 codex review (sync.py merge gate) as a vault_events row. Body of the review is NOT stored — only an HMAC digest of th
• handoff_save Save a session handoff note for cross-device / cross-session continuation. Stored at handoffs/{project}-{topic}-{YYYY-MM-DD}.txt in the user's primary vault. Us
• graph_soft_delete Soft-delete an env_sync graph node (sets deleted_at; .live scope hides it from reads). Idempotent — re-deleting a deleted node is a no-op success.
• env_sync.secret_push Push a new client-encrypted secret. Ciphertext only — server never sees plaintext. Recipients must include the pushing device's own pubkey.
• env_sync.secret_pull Pull an encrypted secret blob. Response is ciphertext_b64 only — server never sees and never returns plaintext.
• env_sync.secret_rotate Rotate a secret: soft-delete the old node, create a new live node with the same alias and the new ciphertext+recipients. 7-day grace before hard delete of old c
• env_sync_txn_push Ingest a batched envelope of client-recorded env_sync mutations. HLC-skew gated, partial-success on conflict.
• env_sync_txn_rollback Inverse-apply a prior env_sync transaction. Safety gates: ownership, idempotency, descendant-conflict (force opt-out).
• tasks_read Read tasks and task categories. action: tasks | categories (consolidated surface — same handlers as the legacy tools)
• task_write Create or update a task. action: create | update. Deletion is a separate tool (delete_task). (consolidated surface — same handlers as the legacy tools) Required
• dev_docs_read Read dev docs. action: get | list | categories | pull (consolidated surface — same handlers as the legacy tools)
• dev_doc_write Create or update a dev doc. action: create | update. Deletion is a separate tool (delete_dev_doc). (consolidated surface — same handlers as the legacy tools) Re
• sync_read Read-only vault sync operations. action: list | pull | diff | merge | conflicts. Writes (push/delete) are separate tools — they carry CAS semantics. (consolidat
• vault_read Read vault metadata. action: list | clone | status (consolidated surface — same handlers as the legacy tools) Required per action — clone: name.
• env_sync_read Read env-sync state. action: devices | drift | status | txn_pull. Secret reads are a separate tool (env_sync.secret_pull). (consolidated surface — same handlers

Details

• Version: 1.3.2
• Transports: streamable-http, stdio
• Uptime (7 days): 100%
• Median latency: 1314 ms
• First indexed: 2026-11-01T09:54:39.825Z
• Last seen in registry: 2026-11-01T09:54:39.836Z
• Repository: https://github.com/seunghan91/ainote
• Website: https://docs.ainote.dev

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.github.seunghan91/ainote.svg)](https://lookupd.com/servers/io.github.seunghan91/ainote)

• 62033 servers
• Last crawl: 2026-11-11T15:38:39.561Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp