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
notesfolder - 🧹 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
- Each message should have:
user_question(required): The user's question to use as the note titlenum_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
.mdextension
Example: Creating_an_MCP_server_1696348800000.md
Development
Build
npm run build
Run Locally
npm start
License
ISC