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.