NoteIt▌

# 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: - **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`: ```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): ```bash claude mcp add --transport http noteit-mcp https://www.noteit-mcp.com/api/mcp ``` Or project scope: ```bash claude mcp add -s project --transport http noteit-mcp https://www.noteit-mcp.com/api/mcp ``` ### Gemini CLI Add the server and authenticate: ```bash 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](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