Skip to content
MCP server

Clean Notes

Kanban tasks and project notes for AI clients, with per-project read or write grants

Install
Pricing
Freemium
Platforms
Web, API
Runs
Remotely
Version
1.0.1
Listing updated
2 days ago

About Clean Notes

Clean Notes is a freemium MCP server for knowledge and memory. It runs as a hosted remote server, so there is nothing to install locally.

Signing in only proves who you are; what an assistant can touch is decided afterwards, project by project. After the OAuth sign-in, Clean Notes asks which projects the connection may reach and whether each is read-only or writable, and a connection with no grant reads nothing. Grants are managed in each project's AI tools panel, and project owners decide whether members may connect their own AI tools.

The server exposes eleven tools: six reads and five writes, with no delete. Updating or completing a task requires an expectedUpdatedAt value and returns a conflict if the record has changed, and every write needs a UUID idempotency key so a retried call does not create a duplicate. Only successful writes use the monthly AI-change allowance, which the site lists as 50, 5,000 and 25,000 across its plans.

It works with GitHub Copilot in VS Code, Claude, ChatGPT and any client that supports Streamable HTTP with OAuth. The vendor says the free plan includes AI access, and the assistant cannot change members, settings or billing.

Install

Run in a terminal

claude mcp add --transport http clean-notes https://cleannotes.app/mcp

Add to Settings → Connectors → Add custom connector

https://cleannotes.app/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "clean-notes": {
      "url": "https://cleannotes.app/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "clean-notes": {
      "type": "http",
      "url": "https://cleannotes.app/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "clean-notes": {
      "serverUrl": "https://cleannotes.app/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "clean-notes": {
      "type": "http",
      "url": "https://cleannotes.app/mcp"
    }
  }
}

Tools this server provides (11)

Taken from the project documentation; the running server may differ.

list_projects
List projects the connection may reach.
get_project
Get a project with its statuses and assignable members.
list_tasks
List tasks filtered by status, assignee or last change.
get_task
Get a task's full details.
list_notes
List note previews.
get_note
Read a note's whole body.
create_task
Create a task.
update_task
Update a task.
complete_task
Complete a task.
create_note
Create a note.
update_note
Update a note.

What it does

Per-project grants
Choose read or write access for each project after sign-in.
Eleven scoped tools
Six read tools and five write tools, with no delete.
Concurrency checks
Updates and completions fail with a conflict if the record changed.
Idempotent writes
Every write needs a UUID key so retries do not duplicate.
Access log
Per-project log of client, tool, time and outcome without call contents.
OAuth 2.1
Dynamic client registration and PKCE; no token to paste.

Good for

  • Ask which tasks in a project are overdue and who owns them
  • Turn meeting notes into assigned tasks with due dates
  • Mark a task done and write a note of the day's decisions
  • See what changed in a project since Monday

Pricing

Freemium

Free plan includes AI access; paid plan prices not listed

Prices change. Check cleannotes.app before you buy.

Clean Notes FAQ

Does the assistant get my whole workspace?

No. A valid token with no project grant reads nothing; you grant projects individually.

Can it delete anything?

No. There is no delete tool, and it cannot change members, settings or billing.

Is AI access free?

The README says the free plan includes AI access, limited to 50 AI changes a month on the smallest plan.

What happens if two edits collide?

The update returns a conflict and the client has to re-read before retrying.

Is Clean Notes free?

Clean Notes has a free plan, with paid plans for more usage or features.

How do I add Clean Notes to Claude Code?

Run this command in your terminal: claude mcp add --transport http clean-notes https://cleannotes.app/mcp

What are the best alternatives to Clean Notes?

The closest alternatives to Clean Notes are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Nautilus Compass Memory.

Alternatives to Clean Notes

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  4. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  5. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  6. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools