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.
noteflow-mcp is a FastMCP v2 server that connects to a notes-style API.
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/postsPOST https://dummyjson.com/posts/addDummyJSON does not require an API key, so NOTES_API_KEY can stay empty.
uv run noteflow-mcp
Or:
uv run python -m noteflow_mcp.server
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.