Claude MarketplacesSubmit
surendhar-23 avatar

Noteflow Mcp

surendhar-23/noteflow-mcp

A straightforward notes interface that wraps any REST API following a simple posts pattern. Ships configured for DummyJSON's free posts endpoint as a backend, letting you create and list notes through two clean tools without authentication. The create_note tool maps to POST requests with title and content fields, while list_notes fetches everything via GET. DummyJSON won't persist your notes since it's a mock API, but swapping in a real backend is just an environment variable change. Useful if you want Claude to maintain a scratch pad during conversations or need a quick proof of concept for note-taking workflows before committing to a database.

tools
2
transport
HTTP
last updated
Mar 10, 2026
View on GitHub

Tools

2 tools

Public tool metadata for what this MCP can expose to an agent.

create_noteCreates a note from a title and content, mapping the content to DummyJSON's body field.

Creates a note from a title and content, mapping the content to DummyJSON's body field.

No parameter schema in public metadata yet.

list_notesLists notes from the notes backend.

Lists notes from the notes backend.

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Readme

noteflow-mcp

noteflow-mcp is a FastMCP v2 server that connects to a notes-style API.

Setup

Install dependencies:

uv sync

Create your environment file:

cp .env.example .env

Then update .env with your real notes API settings.

The current default uses DummyJSON's free posts API as a notes backend:

  • GET https://dummyjson.com/posts
  • POST https://dummyjson.com/posts/add

DummyJSON does not require an API key, so NOTES_API_KEY can stay empty.

Run locally

uv run noteflow-mcp

Or:

uv run python -m noteflow_mcp.server

Exposed tools

  • create_note(title, content)
  • list_notes()

create_note maps note content to DummyJSON's body field. DummyJSON simulates writes for testing, so created notes are not persisted server-side.

Details

Repository
github.com/surendhar-23/noteflow-mcp
Transport
HTTP
Registry
MCP registry, active