Noteit MCP is a visual knowledge management platform that transforms dense technical documentation into interactive HTML pages, Mermaid diagrams, and graph visualizations. It provides structured project notes, tasks, and issues designed to be easily parsed by AI coding assistants. Key capabilities include: - Over 60 reusable agent profiles and personas that shape AI behavior for specific development tasks and workflows - Rich HTML explainers with interactive flows that replace wall-of-text markdown documents - Automatic Mermaid diagram generation for visualizing system architecture and logic flows - Project-based organization of notes, tasks, and technical issues with search capabilities - OAuth 2.1 authentication with device fingerprinting for secure integration with development environments - Cross-IDE support including Cursor, Claude Code, Gemini CLI, and Claude Desktop via proxy - Graph-based visualizations of note relationships for navigating complex technical knowledge

Noteit MCP

[](https://choosealicense.com/licenses/mit/) [](https://modelcontextprotocol.io/) [](https://oauth.net/2.1/)

> 🩹 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:

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?

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:

---

⭐ Star this project

If Noteit MCP helps streamline your AI workflow, please give it a star! It helps others discover this tool and