Noteit Mcp

bahfahh/noteit-mcp

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.

GitHub stars: 5
tools: 8
transport: HTTP
last updated: Dec 11, 2025

View on GitHub

Tools

8 tools

Public tool metadata for what this MCP can expose to an agent.

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

limitnumber

Maximum number of resultsdefault: 10

tagsarray

Filter 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

formatstring

Output formatone of text · xmldefault: text

profileIdstring

Profile ID

profileNamestring

Profile 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

addToProfileboolean

Whether to link to profiledefault: true

contentstring

The content YOU generated (preferred)

namestring

Name for the new resource

profileIdstring

Profile ID to link to (optional)

profileNamestring

Profile name to link to (optional)

promptstring

Legacy: prompt for template generation (fallback)

resourceTypestring

Type of resource to saveone of persona · rule · document · instruction

tagsarray

Tags 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

contentstring

Note content with Markdown and Mermaid support (required). Use ```mermaid blocks for diagrams.

projectNamestring

Determine 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_namestring

recordTypestring

Record type (optional): note(general)/task(todo)/why(explanation)/issue(problem). All types support Mermaid diagrams.one of note · task · why · issue

tagsarray

SMART 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,...

templateIdstring

Template ID (optional)

titlestring

Specific note title/name (required)

noteit_notes_readRead a specific note by ID1 params

Read a specific note by ID

Parameters* required

noteIdstring

Note 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

limitnumber

Maximum number of resultsdefault: 10

projectNamestring

Filter notes by project name. Use this to find notes specific to the current project.

project_namestring

Compatibility alias for projectName

tagsarray

Filter 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

descriptionstring

Brief description of the web page content (optional, recommended for SEO)

html_contentstring

REQUIRED: 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_namestring

Icon name from lucide-react library (e.g., 'Code', 'Database', 'Lock'). Optional.

projectNamestring

Actual 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_namestring

Same as projectName (compatibility format)

tagsarray

SMART 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...

titlestring

Specific 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

descriptionstring

Brief summary of the flow purpose

explanationstring

Detailed 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_dataobject

FLEXIBLE 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_namestring

Project name for organization (defaults to 'default')

tagsarray

SMART 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_idstring

Template identifier for categorization. Common values: 'debug-trace', 'api-flow', 'deployment', 'architecture', 'algorithm', 'system-design', or any custom string.

titlestring

Flow title (e.g., 'OAuth Login Flow', 'Database Migration Process')

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

🎬 Click to watch the complete demo

View the full README on GitHub

Details

Repository: github.com/bahfahh/noteit-mcp
Category: AI & LLM Tools
Transport: HTTP
Registry: MCP registry, active

Related AI & LLM Tools MCP servers

View all

Claude Token Saver Mcpblackfoil/claude-token-saver-mcpMCP server that offloads routine coding tasks to local LLM (Ollama) to save Claude API tokens4stars

Pixel Surgeonj-east/pixel-surgeon-mcpAI image and video generation, editing, and region repair via Gemini, OpenAI, and Grok.4stars

Lore Contextlore-context/lore-contextGoverned AI-agent memory, Evidence Ledger traces, evals, and portable context tools.4stars

Imagine Mcpn24q02m/imagine-mcpMCP server for image/video understanding & generation (Gemini/OpenAI/Grok)4stars

Acmi Mcpmadezmedia/acmiPersistent agent memory via ACMI — Profile/Signals/Timeline. 16 tools on Upstash Redis.3stars

Logic Serverauctalis/nocturnusaiAgent reasoning, memory, and token-optimized context for AI applications.2stars