Skip to content
MCP server

NoteFlow MCP

MCP server that creates and lists notes through a notes-style API, for developers testing

Install
Pricing
Open source
Platforms
CLI, API, self-hosted
Runs
Remotely
Version
1.0.1
Listing updated
today

Similar MCP servers

About NoteFlow MCP

NoteFlow MCP is an open-source MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.

The README describes NoteFlow as a FastMCP v2 server that sits in front of a notes-style API. Out of the box it points at DummyJSON's free posts endpoints, so no API key is needed and it can be run locally with uv. Swapping in a real notes backend is done through the environment file.

The server exposes two tools, create_note and list_notes. Note content is mapped to the body field of the backend. The README also states that DummyJSON simulates writes for testing, so notes created through it are not persisted on the server side.

It suits developers who want a small, readable MCP example or a sandbox for wiring an AI client to note-taking operations before connecting a production notes service.

Install

Run in a terminal

claude mcp add --transport http noteflow-mcp https://2c08-27-4-120-4.ngrok-free.app/mcp

Add to Settings → Connectors → Add custom connector

https://2c08-27-4-120-4.ngrok-free.app/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "noteflow-mcp": {
      "url": "https://2c08-27-4-120-4.ngrok-free.app/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "noteflow-mcp": {
      "type": "http",
      "url": "https://2c08-27-4-120-4.ngrok-free.app/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "noteflow-mcp": {
      "serverUrl": "https://2c08-27-4-120-4.ngrok-free.app/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "noteflow-mcp": {
      "type": "http",
      "url": "https://2c08-27-4-120-4.ngrok-free.app/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

create_note
Creates a note from a title and content.
list_notes
Lists notes.

What it does

Create notes tool
Adds a note with a title and content through the create_note tool.
List notes tool
Returns existing notes via the list_notes tool.
Pluggable notes backend
Configured through an environment file so a real notes API can replace the default.
Local run support
Starts locally with uv or as a Python module.

Good for

  • Testing how an AI client calls note creation and listing tools
  • Learning how to build a FastMCP v2 server around an existing API
  • Prototyping a notes integration without an API key

Pricing

Open source

Open source repository; no paid plan mentioned.

NoteFlow MCP FAQ

Are notes I create saved permanently?

No. The README says DummyJSON simulates writes for testing, so created notes are not persisted server-side.

Does it need an API key?

Not for the default setup. The README says DummyJSON does not require a key, so NOTES_API_KEY can stay empty.

Which tools does it expose?

create_note(title, content) and list_notes().

Is NoteFlow MCP free?

Yes. NoteFlow MCP is open source, so you can use and self-host it for free.

How do I add NoteFlow MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http noteflow-mcp https://2c08-27-4-120-4.ngrok-free.app/mcp

What are the best alternatives to NoteFlow MCP?

The closest alternatives to NoteFlow MCP are fastmcp, MCP Foundry — Build, Test & Publish MCP Servers, Joplin MCP for Claude & ChatGPT, Api Test MCP and fastapi_mcp.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers