FlowNoter MCP Server

A Model Context Protocol (MCP) server for saving conversation notes as markdown files.

Features

• 📝 Save agent conversation history as markdown notes
• 🗂️ Automatically organizes notes in a notes folder
• 🧹 Filters out thinking process and tool execution details
• ⏰ Adds timestamps to each note
• 🎯 Extracts clean responses from assistant messages
• 🔧 Configurable number of conversation turns to save

Installation

Via npm

# Install globally
npm install -g @tricrepe/flownoter

# Or use with npx (no installation needed)
npx @tricrepe/flownoter

Local Development

git clone https://github.com/tricrepe/flownoter.git
cd flownoter
npm install
npm run build

Configuration

Add this to your MCP settings configuration file:

Option 1: Using npx (Recommended)

{
  "mcpServers": {
    "flownoter": {
      "command": "npx",
      "args": ["-y", "@tricrepe/flownoter"]
    }
  }
}

Option 2: Global installation

npm install -g @tricrepe/flownoter

{
  "mcpServers": {
    "flownoter": {
      "command": "flownoter"
    }
  }
}

Option 3: Local development

{
  "mcpServers": {
    "flownoter": {
      "command": "node",
      "args": ["/path/to/flownoter/dist/index.js"]
    }
  }
}

Available Tools

save_conversation_note

Saves recent conversation messages as a markdown note.

Parameters:

• messages (required): Array of conversation messages
  • Each message should have:
    • role: Either "user" or "assistant"
    • content: The message content
• user_question (required): The user's question to use as the note title
• num_messages (optional): Number of recent conversation turns to include (default: all messages)

Example:

{
  "messages": [
    {
      "role": "user",
      "content": "How do I create an MCP server?"
    },
    {
      "role": "assistant",
      "content": "To create an MCP server, you need to..."
    }
  ],
  "user_question": "Creating an MCP server",
  "num_messages": 1
}

Output Format

Notes are saved in the notes/ folder with the following format:

# [User Question]

**Created:** [ISO 8601 Timestamp]

---

## Question

[User's question]

## Answer

[Assistant's clean response without thinking process or tool calls]

File Naming

Note files are named using:

• Sanitized version of the user's question (alphanumeric characters and Chinese characters only)
• Timestamp for uniqueness
• .md extension

Example: Creating_an_MCP_server_1696348800000.md

Development

Build

npm run build

Run Locally

npm start

License

ISC