NoteFlow MCP
MCP server that creates and lists notes through a notes-style API, for developers testing
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://2c08-27-4-120-4.ngrok-free.app/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"noteflow-mcp": {
"url": "https://2c08-27-4-120-4.ngrok-free.app/mcp"
}
}
}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.
