Back to the catalog

io.github.Surendhar-23/NoteFlow-MCP

An MCP server that used to create notes

Open source Repository Open in the app JSON README (API)

About

An MCP server that used to create notes

Details

Kind
MCP servers
Topic
No topic detected
Publisher
surendhar-23
Origin
official
Category
ferramentas
Transport
http
Version
1.0.1
Last push
2026-03-10T05:38:11Z
Repository state
ativo
Language
Python
Added
2026-08-29 03:02:16
Updated
2026-08-29 03:02:16
Origin id
io.github.Surendhar-23/NoteFlow-MCP

README

# noteflow-mcp

`noteflow-mcp` is a FastMCP v2 server that connects to a notes-style API.

## Setup

Install dependencies:

```bash
uv sync
```

Create your environment file:

```bash
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

```bash
uv run noteflow-mcp
```

Or:

```bash
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.

More