Clean Notes

app.cleannotesPublished by cleannotes.appOfficial publisherv1.0.1Updated Oct 26, 2026

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

VerifiedStreamable HTTPWeb executableProductivity & Workflow Knowledge & Memory

Server details

Identifier: app.cleannotes/clean-notes
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Oct 15, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified that this server's namespace belongs to cleannotes.app, which also runs its endpoint. That identifies the publisher; it does not make the server's tools safe.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/app.cleannotes%2Fclean-notes.svg)](https://sourceweft.com/mcp/app.cleannotes%2Fclean-notes?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Hosted MCP server that lets an AI assistant read and update Clean Notes kanban tasks and project notes in the projects you explicitly grant.

What you can do: List and read projects, including statuses and assignable members
List and read tasks, filtered by status, assignee or last change, with paging
List and read project notes, as previews or full bodies
Create and update tasks, and mark them done
Create and update notes, including pinning
When to use it: Useful for small teams already working in Clean Notes who want an assistant to answer questions about overdue or blocked tasks, turn meeting notes into tasks, update task status, or write project notes, without leaving the chat client.
Requirements: A remote Streamable HTTP endpoint; nothing to install locally. A Clean Notes account is required, and AI access is included on the free plan. Sign-in uses OAuth 2.1 with dynamic client registration and PKCE, so no API key or token is pasted. After signing in you choose which projects the connection may reach and whether each is read-only or read-and-change.

Before you install

Write tools create and update tasks and notes in granted projects; nothing can be deleted, and members, settings and billing cannot be changed. A connection with no project grant reads nothing, and write calls are refused outside projects granted change access. Each project keeps an activity log of AI changes (client, tool, time, outcome; metadata only). AI changes count against a monthly allowance (50 free, 5,000 Pro, 25,000 Scale), and paid plans cost money.

Installation

In SourceWeft

Open Clean Notes in the dashboard and add it to a workspace.
Connect the required credentials. They are stored privately and never shown on public pages.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/app.cleannotes%2Fclean-notes/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

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

README

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


Endpoint	`https://cleannotes.app/mcp`
Transport	Streamable HTTP, stateless
Authentication	OAuth 2.1 with dynamic client registration and PKCE. No API key or token to paste.
Tools	11: six read, five write, no delete
Registry name	`app.cleannotes/clean-notes`

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):

json

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

{  "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

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

Tool	Access	What it does
`clean_notes_list_projects`	read	Lists the projects this connection may reach.
`clean_notes_get_project`	read	Returns a project with its ordered statuses and the members who can be assigned.
`clean_notes_list_tasks`	read	Lists tasks, filtered by status, assignee or last change, with a cursor and a limit.
`clean_notes_get_task`	read	Returns a task with its full details.
`clean_notes_list_notes`	read	Lists notes as short previews, with a cursor.
`clean_notes_get_note`	read	Returns a note's whole body.
`clean_notes_create_task`	write	Creates a task: title, details, status, priority, assignee and dates.
`clean_notes_update_task`	write	Changes a task's fields.
`clean_notes_complete_task`	write	Marks a task as done.
`clean_notes_create_note`	write	Creates a note with a title and a body, optionally pinned.
`clean_notes_update_note`	write	Edits a note's title, body or pin.

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.

Tools

This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

v1.0.1LatestOct 20, 2026
v1.0.0Oct 15, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts
Declare a license in the repository or the registry entry.

Plan	Price	AI changes per month
Free	$0	50
Pro	$4.90 per month	5,000
Scale	$14.90 per month	25,000

Clean Notes

Overview

Installation

In SourceWeft

Use with an agent

Other MCP clients

README

Clean Notes MCP server

Configure

VS Code with GitHub Copilot

Claude Code

Claude (app and web)

ChatGPT

Any other MCP client

Choose what the assistant can reach

Use it

Tools

Built to be retried safely

Pricing

Links

Tools

Version history

Score