# NoteFlow MCP

> NoteFlow MCP is an open-source MCP server for developer tools. MCP server that creates and lists notes through a notes-style API, for developers testing. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Repository:** https://github.com/surendhar-23/noteflow-mcp
- **MCP Registry name:** io.github.Surendhar-23/NoteFlow-MCP
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://2c08-27-4-120-4.ngrok-free.app/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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.

## Alternatives

- [fastmcp](https://ai-powered.com/mcp/fastmcp): fastmcp is an open-source MCP server for developer tools.
- [MCP Foundry — Build, Test & Publish MCP Servers](https://ai-powered.com/mcp/mcp-foundry-build-test-and-publish-mcp-servers): MCP Foundry — Build, Test & Publish MCP Servers is a freemium MCP server for developer tools.
- [Joplin MCP for Claude & ChatGPT](https://ai-powered.com/mcp/joplin-mcp-for-claude-and-chatgpt): Joplin MCP for Claude & ChatGPT is an open-source MCP server for ai models and llm tooling.
- [Api Test MCP](https://ai-powered.com/mcp/api-test-mcp): Api Test MCP is an open-source MCP server for developer tools.
- [fastapi_mcp](https://ai-powered.com/mcp/fastapi-mcp): fastapi_mcp is an open-source MCP server for ai models and llm tooling.
- [Airflow MCP Server](https://ai-powered.com/mcp/airflow-mcp-server): Airflow MCP Server is an open-source MCP server for developer tools.
- [ArborNote MCP by usefulapi](https://ai-powered.com/mcp/arbornote-mcp-by-usefulapi): ArborNote MCP by usefulapi is a freemium MCP server for developer tools.
- [Estuary Flow MCP by usefulapi](https://ai-powered.com/mcp/estuary-flow-mcp-by-usefulapi): Estuary Flow MCP by usefulapi is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/noteflow-mcp
