什么是 noteit-mcp?
为项目创建笔记、任务和 Issue,并结合 Mermaid 图、交互流程与 HTML 说明;按项目搜索整理知识与配置组件。
核心功能 (8 个工具)
noteit_profiles_listList user agent profiles - configuration sets for AI behavior. When using profiles with personas, adopt their characteristics and follow any instructions provided.
noteit_profiles_getConfigGET AGENT CONFIGURATION: Retrieve a composable AI agent configuration profile containing personas, instructions, rules, and documents. When a profile contains persona settings, adopt that persona and follow its behavioral patterns. When it contains instructions, execute those instructions as requested. Use this to get configuration settings that define how you should behave and respond for specific tasks or roles.
noteit_profiles_generateCREATE AGENT CONFIGURATION COMPONENTS: Generate and save individual configuration components (persona, rule, document, instruction) that can be assembled into agent profiles. Use 'content' parameter with YOUR generated content. This is for building configuration sets, not for note-taking.
noteit_notes_createCreate notes with Mermaid diagram support. IMPORTANT: title ≠ projectName. title = specific note title/name, projectName = actual repository/project name the user is currently working on (e.g., 'my-ecommerce-site', 'data-analyzer', 'mobile-app'). CRITICAL: Ask user for their current project name if not specified, or infer from current working directory/context. DO NOT make up project names based on note titles. VISUAL STRATEGY BY RECORD TYPE: note(general)=balanced text+diagrams, task(todo)=primarily text-based, why(explanation)=emphasize visual diagrams for clarity, issue(problem)=diagrams when helpful for analysis. ENCOURAGE using Mermaid diagrams when appropriate - especially for database structures (erDiagram), workflows (flowchart), system architecture (graph), API sequences (sequenceDiagram). For class relationships, use SIMPLE classDiagram syntax only. Supports 4 record types (note/task/why/issue). Required: title, content, projectName. SMART TAG LOGIC: IF content is tech-related (programming, development, tools), provide exactly ONE relevant tag from: frontend, backend, database, bug-fix, feature, documentation, testing, refactor, config, api, ui, performance, security. IF content is personal/life notes (weather, diary, random thoughts), provide NO tags. IF user specifies tags, use exactly what user provides. Only provide multiple tags if user explicitly requests 'multiple tags'. Mermaid v11.10.0 COMPATIBLE types: graph TD/LR, flowchart TD/LR, sequenceDiagram, erDiagram, gantt, pie, stateDiagram, stateDiagram-v2. For classDiagram: ONLY use basic syntax (class ClassName { +field: type +method() }, inheritance with <|--). AVOID: complex classDiagram features, interfaces, annotations, multiplicity. MERMAID SAFETY CHECKLIST: use ASCII arrows (`-->`), quote labels containing spaces/CJK/special characters, avoid gitgraph, and when you define multiple `subgraph` blocks, connect them with at least one edge so clusters stay linked and render at normal scale. NOTE: This is for note-taking, separate from agent profile configuration.
noteit_notes_readRead a specific note by ID
noteit_notes_listList user notes with optional tag and project filtering. Use 'projectName' to filter by project, or omit for cross-project search. Results show project name for context. NOTE: This is for note-taking, separate from agent profile configuration.
noteit_web_createGenerate interactive HTML notes to help developers UNDERSTAND complex concepts, processes, or technical details. This is a NOTE-TAKING tool (like Markdown notes, but richer HTML format) — NOT for building websites. Creates self-contained, single-file HTML explanations stored in database (private, noindex). LAYOUT SELECTION (choose based on content): (1) CENTERED NAVIGATION: Use when steps ≤ 5 OR content is simple/focused (quick tutorials, concept explanations, bug fixes). Features: pure black background, horizontal step indicators, center content. (2) SIDEBAR NAVIGATION: Use when steps ≥ 6 OR content is comprehensive (long docs, complete workflows, architecture deep-dives). Features: dark slate background, fixed left sidebar navigation. VISUAL BASELINE: Tailwind CSS (CDN), Inter/JetBrains Mono fonts, dark theme, responsive design. ENCOURAGE: animations, step indicators, code comparisons (before/after), interactive demos, smooth transitions, keyboard navigation. FOR SIDEBAR LAYOUTS: Prefer using 'App Shell' pattern (flex h-screen overflow-hidden) over 'position: fixed' to ensure stability in sandboxed environments. MERMAID SAFETY: Write in <div class="mermaid">sequenceDiagram...</div> (NO code blocks). Use dark theme - ensure text/line colors are visible on dark background. CRITICAL: participants must be ACTIVE entities (services/users) that send/receive messages - NOT passive data (Params/Payload/Config). Quote labels with spaces/CJK. Match diagram complexity to text focus. Connect multiple subgraphs with edges. CODE FORMATTING (CRITICAL): For ANY multi-line code (Python/JS/TypeScript/etc), file trees, directory structures, ALWAYS use <pre><code> tags together OR add style="white-space: pre-wrap; display: block;" to <code>. Plain <code> alone compresses whitespace and newlines causing code to display as single line. ANCHOR NAVIGATION (CRITICAL for SPA): MUST add JavaScript at end of <body>: capture all anchor clicks with preventDefault/stopPropagation, use element.scrollIntoView({behavior:'smooth'}), update URL with history.replaceState. Add scroll-margin-top to sections. Implement active state switching on nav links. Use when explaining: OAuth flows, rendering pipelines, architecture, API workflows, algorithm logic. Required: title, html_content (complete <!DOCTYPE html>), projectName. Optional: description, tags, icon_name.
noteit_flow_createCreate visual flow diagrams with NESTED DATA SUPPORT for ANY technical process visualization. Use this for: debugging flows, architecture diagrams, deployment pipelines, API workflows, algorithm steps, system interactions, or any step-by-step process. The flow is rendered as an interactive React Flow diagram with automatic layout and CHILD NODES for nested data. FLEXIBLE STRUCTURE: Design your own JSON structure - just include an array of items (steps/workflow/pipeline/scenarios). NESTED DATA: Each item can include child data (config objects, commands arrays, steps arrays, resources, metrics, etc.) which will be rendered as separate child nodes connected with dashed lines. Common patterns: {steps: [{id, label, type, detail}]} for simple linear flows, {workflow: [{id, label, type, detail, config: {...}, commands: [...], steps: [...], resources: [...]}]} for complex flows with nested metadata. Required: title, template_id (any string for categorization), explanation (detailed context explaining both main flow and nested data), flow_data (your custom JSON with at least one array field). Optional fields per item: 'type' for styling (input/process/output/error/warning/success/source/result), 'detail' for description, plus NESTED DATA FIELDS: 'config' (object), 'commands' (array of {cmd, result}), 'steps' (array of strings), 'resources' (array of objects), 'records' (array), 'metrics' (array), 'summary' (object). The renderer automatically creates child nodes for nested data and connects them with dashed lines to parent nodes. The flow appears in dashboard alongside notes.
README
Noteit MCP
🩹 The cure for AI "Markdown Hell" - AI prompt library + visual knowledge hub for developers
Noteit-MCP transforms drowning in 5,000-word documents into navigable HTML and logic diagrams instantly. With 60+ expert personas, organize complex ideas without cognitive overload. Makes Specification-Driven Development actually human-readable.
✨ Demo & Screenshots
🎥 Noteit MCP in Action - Complete usage walkthrough
<p align="center"> <a href="https://www.youtube.com/watch?v=-cRqrBOzKIc&t=24s"> <img src="https://img.youtube.com/vi/-cRqrBOzKIc/0.jpg" alt="Noteit MCP Demo Video" width="800" /> </a> <br /> <em>🎬 Click to watch the complete demo</em> </p> <p align="center"> <img src="assets/demo/noteweb.png" alt="Noteit Dashboard" width="800" /> <br /> <em>📊 Unified dashboard with agent profiles and note management</em> </p> <p align="center"> <img src="assets/demo/noteweb2.png" alt="Agent Profiles" width="800" /> <br /> <em>🤖 40+ pre-built agent templates for different coding tasks</em> </p> <p align="center"> <img src="assets/demo/noteweb3.png" alt="Note Taking" width="800" /> <br /> <em>📝 AI-readable notes with graph visualizations</em> </p>1) What is Noteit MCP?
Noteit MCP is an HTTP MCP server (Next.js API route) that lets AI coding tools securely access two core systems:
- Agent Profiles: Composable configurations (personas, instructions, rules, documents) that shape AI behavior for specific tasks.
- Notes: Personal note-taking with structured records and graph visualizations.
Authentication uses OAuth 2.1 with device fingerprint for IDEs that support it, with an optional API Token flow for other MCP clients. The server endpoint is exposed at /api/mcp.
2) Why use Noteit MCP?
- Unified configuration: Reusable agent profiles that any AI client can adopt.
- Productive note-taking: AI-readable notes, tasks, and visual graphs.
- Secure by design: OAuth 2.1 + transparent token refresh; API token for non‑OAuth clients.
- Works across IDEs: Cursor, Claude Code, Gemini CLI, Claude Desktop (via proxy), and more.
3) How to connect
The MCP server is at https://www.noteit-mcp.com/api/mcp.
Cursor (mcp.json)
Create or update ~/.cursor/mcp.json:
{
"mcpServers": {
"noteit-mcp": {
"url": "https://www.noteit-mcp.com/api/mcp"
}
}
}
Then restart Cursor. OAuth will be handled automatically.
Claude Code (built-in MCP)
Use the command-line helper (global scope):
claude mcp add --transport http noteit-mcp https://www.noteit-mcp.com/api/mcp
Or project scope:
claude mcp add -s project --transport http noteit-mcp https://www.noteit-mcp.com/api/mcp
Gemini CLI
Add the server and authenticate:
gemini mcp add --transport http noteit-mcp https://www.noteit-mcp.com/api/mcp
/mcp auth noteit-mcp
/mcp # verify tools are listed
Other IDEs (API Token)
Login at https://www.noteit-mcp.com to obtain an API token.
4) Available Tools
Through Noteit-MCP, agents can use the following tools:
- noteit_profiles_list: List user agent profiles - configuration sets containing personas, instructions, rules, and documents for specific roles or tasks
- noteit_profiles_getConfig: Retrieve a composable AI agent configuration profile containing personas, instructions, rules, and documents
- noteit_profiles_generate: Generate and save individual configuration components (persona, rule, document, instruction) that can be assembled into agent profiles
- noteit_notes_create: Create project notes with 4 specialized types: "note" for general records, "task" for development assignments, "why" for explanations, "issue" for problems and bugs
- noteit_notes_read: Retrieve complete content of a specific note by its unique ID
- noteit_notes_list: Browse and filter all user notes across projects with optional filtering by tags, record types, or project names
- noteit_web_create: Generate interactive HTML notes to help developers understand complex concepts, processes, or technical details
- noteit_flow_create: Create visual flow diagrams with nested data support for technical process visualization
⭐ Star this project
If Noteit MCP helps streamline your AI workflow, please give it a star! It helps others discover this tool and motivates continued development.
License
MIT
常见问题
noteit-mcp 是什么?
为项目创建笔记、任务和 Issue,并结合 Mermaid 图、交互流程与 HTML 说明;按项目搜索整理知识与配置组件。
noteit-mcp 提供哪些工具?
提供 8 个工具,包括 noteit_profiles_list、noteit_profiles_getConfig、noteit_profiles_generate 等。
相关 Skills
表格处理
by anthropics
围绕 .xlsx、.xlsm、.csv、.tsv 做读写、修复、清洗、格式整理、公式计算与格式转换,适合修改现有表格、生成新报表或把杂乱数据整理成交付级电子表格。
✎ 做 Excel/CSV 相关任务很省心,能直接读写、修复、清洗和格式转换,尤其擅长把乱七八糟的表格整理成交付级文件。
PDF处理
by anthropics
遇到 PDF 读写、文本表格提取、合并拆分、旋转加水印、表单填写或加解密时直接用它,也能提取图片、生成新 PDF,并把扫描件通过 OCR 变成可搜索文档。
✎ PDF杂活别再来回切工具了,文本表格提取、合并拆分到OCR识别一次搞定,连扫描件也能变可搜索。
Word文档
by anthropics
覆盖Word/.docx文档的创建、读取、编辑与重排,适合生成报告、备忘录、信函和模板,也能处理目录、页眉页脚、页码、图片替换、查找替换、修订批注及内容提取整理。
✎ 搞定 .docx 的创建、改写与精排版,目录、批量替换、批注修订和图片更新都能自动化,做正式文档尤其省心。
相关 MCP Server
文件系统
编辑精选by Anthropic
Filesystem 是 MCP 官方参考服务器,让 LLM 安全读写本地文件系统。
✎ 这个服务器解决了让 Claude 直接操作本地文件的痛点,比如自动整理文档或生成代码文件。适合需要自动化文件处理的开发者,但注意它只是参考实现,生产环境需自行加固安全。
by wonderwhy-er
Desktop Commander 是让 AI 直接执行终端命令、管理文件和进程的 MCP 服务器。
✎ 这工具解决了 AI 无法直接操作本地环境的痛点,适合需要自动化脚本调试或文件批量处理的开发者。它能让你用自然语言指挥终端,但权限控制需谨慎,毕竟让 AI 执行 rm -rf 可不是闹着玩的。
EdgarTools
编辑精选by dgunning
EdgarTools 是无需 API 密钥即可解析 SEC EDGAR 财报的开源 Python 库。
✎ 这个工具解决了金融数据获取的痛点——直接让 AI 读取结构化财报,比如让 Claude 分析苹果的 10-K 文件。适合量化分析师或金融开发者快速构建数据管道。但注意,它依赖 SEC 网站稳定性,高峰期可能延迟。