Summary
If you're tired of maintaining scattered AI prompts and fighting markdown bloat in long-form specs, this gives you a centralized profile and note system your AI can query directly. It exposes six tools: list and fetch agent profiles with their personas and instructions, generate new configuration components, create typed notes (task, issue, why, general), read individual notes, and render complex concepts as HTML or flow diagrams. The OAuth 2.1 setup works natively in Cursor and Claude Code, with API token fallback for other clients. Think of it as a shared knowledge layer where you build reusable agent configs once and let any MCP-compatible tool pull them in, plus a structured notebook that outputs visual artifacts instead of wall-of-text markdown.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
8 tools
noteit_profiles_listList user agent profiles - configuration sets for AI behavior. When using profiles with personas, adopt their characteristics and follow any instructions provided.2 params
List user agent profiles - configuration sets for AI behavior. When using profiles with personas, adopt their characteristics and follow any instructions provided.
Parameters* required
tagsarrayFilter by tags
limitnumberMaximum number of resultsdefault: 10
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...3 params
GET 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...
Parameters* required
formatstringOutput formatone of
text · xmldefault: textprofileIdstringProfile ID
profileNamestringProfile name
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...8 params
CREATE 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...
Parameters* required
namestringName for the new resource
tagsarrayTags for the resource. Default to ['AI-generated'] unless user specifies otherwise.
promptstringLegacy: prompt for template generation (fallback)
contentstringThe content YOU generated (preferred)
profileIdstringProfile ID to link to (optional)
profileNamestringProfile name to link to (optional)
addToProfilebooleanWhether to link to profiledefault: true
resourceTypestringType of resource to saveone of
persona · rule · document · instructionnoteit_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 c...7 params
Create 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 c...
Parameters* required
tagsarraySMART TAG LOGIC: IF content is tech-related (programming, development, tools), provide exactly ONE 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'.
titlestringSpecific note title/name (required)
contentstringNote content with Markdown and Mermaid support (required). Use ```mermaid blocks for diagrams.
recordTypestringRecord type (optional): note(general)/task(todo)/why(explanation)/issue(problem). All types support Mermaid diagrams.one of
note · task · why · issuetemplateIdstringTemplate ID (optional)
projectNamestringDetermine the project name as follows: 1. If the project name is already known, use it directly. 2. Otherwise, use the basename of the current working directory. 3. If that is unknown, try `git rev-parse --show-toplevel | xargs basename`. 4. If neither method works, fall back to the current directory's basename as a temporary project name (required)
project_namestringDetermine the project name as follows: 1. If the project name is already known, use it directly. 2. Otherwise, use the basename of the current working directory. 3. If that is unknown, try `git rev-parse --show-toplevel | xargs basename`. 4. If neither method works, fall back to the current directory's basename as a temporary project name (compatibility format, optional)
noteit_notes_readRead a specific note by ID1 params
Read a specific note by ID
Parameters* required
noteIdstringNote 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.4 params
List 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.
Parameters* required
tagsarrayFilter by tags
limitnumberMaximum number of resultsdefault: 10
projectNamestringFilter notes by project name. Use this to find notes specific to the current project.
project_namestringCompatibility alias for projectName
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 i...7 params
Generate 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 i...
Parameters* required
tagsarraySMART TAG LOGIC: Provide exactly ONE relevant tag from: tutorial, deployment, security, architecture, api, oauth, database, performance, guide, reference. IF user specifies tags in their message, use exactly what user provides. Only provide multiple tags if user explicitly requests 'multiple tags'. If no clear category, omit this parameter.
titlestringSpecific web page title/name (required)
icon_namestringIcon name from lucide-react library (e.g., 'Code', 'Database', 'Lock'). Optional.
descriptionstringBrief description of the web page content (optional, recommended for SEO)
projectNamestringActual repository/project name the user is currently working on (required). Ask user if not specified, or infer from working directory. DO NOT make up project names.
html_contentstringREQUIRED: Complete HTML document with <!DOCTYPE html>, <html>, <head>, and <body> tags. You MUST provide this parameter. If your IDE truncates output, retry with: Tailwind CDN, Mermaid.js for diagrams (not SVG), keep under 15KB.
project_namestringSame as projectName (compatibility format)
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 a...7 params
Create 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 a...
Parameters* required
tagsarraySMART TAG LOGIC: Provide exactly ONE relevant tag from: debug, bug-fix, architecture, testing, deployment, api, database, performance, security, workflow, algorithm, system-design. IF user specifies tags in their message, use exactly what user provides. Only provide multiple tags if user explicitly requests 'multiple tags'. If no clear category, omit this parameter.
titlestringFlow title (e.g., 'OAuth Login Flow', 'Database Migration Process')
flow_dataobjectFLEXIBLE JSON structure for your flow with NESTED DATA SUPPORT. Must contain at least ONE array field with flow items (steps/workflow/pipeline/scenarios). Each item should have: 'id', 'label', 'type' (optional), 'detail' (optional), plus nested data fields like 'config', 'commands', 'steps', 'resources', 'records', 'metrics', 'summary'.
descriptionstringBrief summary of the flow purpose
explanationstringDetailed explanation displayed in the left panel. Describe: What problem does this solve? What's the context? Key insights? If using nested data, explain what each child node represents.
template_idstringTemplate identifier for categorization. Common values: 'debug-trace', 'api-flow', 'deployment', 'architecture', 'algorithm', 'system-design', or any custom string.
project_namestringProject name for organization (defaults to 'default')
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
🎬 Click to watch the complete demo
📊 Unified dashboard with agent profiles and note management
🤖 40+ pre-built agent templates for different coding tasks
📝 AI-readable notes with graph visualizations
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.
60+ expert personas for different coding tasks and workflows
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
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
