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.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →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
limitnumberMaximum number of resultsdefault: 10
tagsarrayFilter by tags
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
addToProfilebooleanWhether to link to profiledefault: true
contentstringThe content YOU generated (preferred)
namestringName for the new resource
profileIdstringProfile ID to link to (optional)
profileNamestringProfile name to link to (optional)
promptstringLegacy: prompt for template generation (fallback)
resourceTypestringType of resource to saveone of
persona · rule · document · instructiontagsarrayTags for the resource. Default to ['AI-generated'] unless user specifies otherwise.
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 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
contentstringNote content with Markdown and Mermaid support (required). Use ```mermaid blocks for diagrams.
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...
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...
recordTypestringRecord type (optional): note(general)/task(todo)/why(explanation)/issue(problem). All types support Mermaid diagrams.one of
note · task · why · issuetagsarraySMART 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,...
templateIdstringTemplate ID (optional)
titlestringSpecific note title/name (required)
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
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
tagsarrayFilter by tags
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
descriptionstringBrief description of the web page content (optional, recommended for SEO)
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 diagr...
icon_namestringIcon name from lucide-react library (e.g., 'Code', 'Database', 'Lock'). Optional.
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.
project_namestringSame as projectName (compatibility format)
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, u...
titlestringSpecific web page title/name (required)
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
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.
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', 'typ...
project_namestringProject name for organization (defaults to 'default')
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 specifie...
template_idstringTemplate identifier for categorization. Common values: 'debug-trace', 'api-flow', 'deployment', 'architecture', 'algorithm', 'system-design', or any custom string.
titlestringFlow title (e.g., 'OAuth Login Flow', 'Database Migration Process')
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
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
