# Clean Notes

> Clean Notes is a freemium MCP server for knowledge and memory. Kanban tasks and project notes for AI clients, with per-project read or write grants. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, API
- **Website:** https://cleannotes.app/en/ai/mcp
- **Repository:** https://github.com/gelborn/clean-notes-mcp
- **MCP Registry name:** app.cleannotes/clean-notes
- **Categories:** knowledge and memory, productivity
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://cleannotes.app/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "clean-notes": {
      "url": "https://cleannotes.app/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

---
Source: https://ai-powered.com/mcp/clean-notes
