Clean Notes

Clean Notes MCP server

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

Clean Notes is a project workspace for small teams: a kanban board with list and timeline views, project notes beside the tasks they explain, and realtime updates. Its MCP server lets GitHub Copilot, ChatGPT, Claude or any MCP client read and update the projects you approve, and nothing else.

[Install in VS Code] [Install in VS Code Insiders]

This repository documents the hosted server. There is nothing to install or run locally: you point your client at the endpoint and sign in.

You need a Clean Notes account. The free plan includes AI access.

Configure

VS Code with GitHub Copilot

Use the install button above, or add the server to .vscode/mcp.json in your workspace (or to your user mcp.json):

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

Start the server. When VS Code asks to sign in to Clean Notes, allow it; your browser opens Clean Notes, where you sign in and choose the projects to share. The tools then appear in Copilot Chat in agent mode.

Claude Code

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

Then run /mcp in Claude Code and choose Authenticate next to Clean Notes.

Claude (app and web)

Settings → Connectors → Add custom connector, paste https://cleannotes.app/mcp, and authenticate.

ChatGPT

Open the Clean Notes plugin, connect your account and authorize your projects.

Any other MCP client

Register https://cleannotes.app/mcp as a Streamable HTTP server and finish the OAuth sign-in in your browser. The client discovers everything else from https://cleannotes.app/.well-known/oauth-protected-resource.

Choose what the assistant can reach

Signing in proves who you are; it does not open your workspace. Right after the sign-in, Clean Notes asks which projects this connection may reach and, for each one, whether it may only read or also make changes. A connection with no project grant reads nothing.

• Grants are made and revoked in Clean Notes, in each project's AI tools panel.
• Project owners decide whether members may connect their own AI tools.
• The assistant cannot delete anything, and cannot change members, settings or billing.

Use it

Ask in plain language, for example:

• "Which tasks in my Launch project are overdue or blocked, and who owns each one?"
• "Create tasks in my Launch project from these meeting notes, with an owner and a due date for each."
• "Mark the pricing page task as done and write a project note with today's decisions."
• "What changed in the Website project since Monday?"

Tools

Write tools work only in projects granted read and change; anywhere else the call is refused.

Built to be retried safely

• Every write takes an idempotency key, so a repeated call returns the first result instead of creating a second task or note.
• Updates and completion carry the record's expectedUpdatedAt. If someone else changed it first, the call fails with a conflict instead of overwriting their edit, and the assistant re-reads before trying again.
• Every tool is closed-world: it reads and writes the authorized projects only and never reaches the internet.
• Each project keeps an activity log of AI changes, with the client, tool, time and outcome. It stores metadata, not the contents of the calls.

Pricing

AI access is on every plan. Only successful changes count toward the monthly allowance; reads, conflicts and rejected calls are free.

Billing follows the projects you create, so people you invite never pay for a seat. See pricing.

Links

• Documentation: cleannotes.app/en/ai/mcp
• Website: cleannotes.app
• Support: cleannotes.app/en/support or [email protected]
• Privacy policy · Terms

Clean Notes is a proprietary hosted service. This repository holds its public documentation only; the server's source code is not published here.