Clean Notes
Kanban tasks and project notes for AI clients, with per-project read or write grants
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://cleannotes.app/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"clean-notes": {
"url": "https://cleannotes.app/mcp"
}
}
}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

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Claude Code Ultimate Guide
MCP serverMCP 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

Nautilus Compass Memory
MCP serverLocal-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

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools