{
  "markdown": "<p align=\"center\">\n  <img src=\"assets/log.png\" alt=\"Noteit MCP\" width=\"180\" />\n</p>\n\n# Noteit MCP\n\n[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)\n[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-blue.svg)](https://modelcontextprotocol.io/)\n[![OAuth 2.1](https://img.shields.io/badge/Auth-OAuth%202.1-orange.svg)](https://oauth.net/2.1/)\n\n> **🩹 The cure for AI \"Markdown Hell\" - AI prompt library + visual knowledge hub for developers**\n\nNoteit-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.\n\n## ✨ Demo & Screenshots\n\n🎥 **Noteit MCP in Action** - Complete usage walkthrough\n\n<p align=\"center\">\n  <a href=\"https://www.youtube.com/watch?v=-cRqrBOzKIc&t=24s\">\n    <img src=\"https://img.youtube.com/vi/-cRqrBOzKIc/0.jpg\" alt=\"Noteit MCP Demo Video\" width=\"800\" />\n  </a>\n  <br />\n  <em>🎬 Click to watch the complete demo</em>\n</p>\n\n<p align=\"center\">\n  <img src=\"assets/demo/noteweb.png\" alt=\"Noteit Dashboard\" width=\"800\" />\n  <br />\n  <em>📊 Unified dashboard with agent profiles and note management</em>\n</p>\n\n<p align=\"center\">\n  <img src=\"assets/demo/noteweb2.png\" alt=\"Agent Profiles\" width=\"800\" />\n  <br />\n  <em>🤖 40+ pre-built agent templates for different coding tasks</em>\n</p>\n\n<p align=\"center\">\n  <img src=\"assets/demo/noteweb3.png\" alt=\"Note Taking\" width=\"800\" />\n  <br />\n  <em>📝 AI-readable notes with graph visualizations</em>\n</p>\n\n## 1) What is Noteit MCP?\n\nNoteit MCP is an HTTP MCP server (Next.js API route) that lets AI coding tools securely access two core systems:\n\n- **Agent Profiles**: Composable configurations (personas, instructions, rules, documents) that shape AI behavior for specific tasks.\n- **Notes**: Personal note-taking with structured records and graph visualizations.\n\nAuthentication 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`.\n\n## 2) Why use Noteit MCP?\n\n- **Unified configuration**: Reusable agent profiles that any AI client can adopt.\n- **Productive note-taking**: AI-readable notes, tasks, and visual graphs.\n- **Secure by design**: OAuth 2.1 + transparent token refresh; API token for non‑OAuth clients.\n- **Works across IDEs**: Cursor, Claude Code, Gemini CLI, Claude Desktop (via proxy), and more.\n\n<p align=\"center\">\n  <img src=\"assets/prompt.png\" alt=\"Noteit MCP UI\" width=\"900\" />\n  <br />\n  <em>60+ expert personas for different coding tasks and workflows</em>\n</p>\n\n## 3) How to connect\n\nThe MCP server is at `https://www.noteit-mcp.com/api/mcp`.\n\n### Cursor (mcp.json)\n\nCreate or update `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"noteit-mcp\": {\n      \"url\": \"https://www.noteit-mcp.com/api/mcp\"\n    }\n  }\n}\n```\n\nThen restart Cursor. OAuth will be handled automatically.\n\n### Claude Code (built-in MCP)\n\nUse the command-line helper (global scope):\n\n```bash\nclaude mcp add --transport http noteit-mcp https://www.noteit-mcp.com/api/mcp\n```\n\nOr project scope:\n\n```bash\nclaude mcp add -s project --transport http noteit-mcp https://www.noteit-mcp.com/api/mcp\n```\n\n### Gemini CLI\n\nAdd the server and authenticate:\n\n```bash\ngemini mcp add --transport http noteit-mcp https://www.noteit-mcp.com/api/mcp\n/mcp auth noteit-mcp\n/mcp  # verify tools are listed\n```\n\n### Other IDEs (API Token)\n\nLogin at [https://www.noteit-mcp.com](https://www.noteit-mcp.com/) to obtain an API token.\n\n---\n\n## 4) Available Tools\n\nThrough Noteit-MCP, agents can use the following tools:\n\n- **noteit_profiles_list**: List user agent profiles - configuration sets containing personas, instructions, rules, and documents for specific roles or tasks\n- **noteit_profiles_getConfig**: Retrieve a composable AI agent configuration profile containing personas, instructions, rules, and documents\n- **noteit_profiles_generate**: Generate and save individual configuration components (persona, rule, document, instruction) that can be assembled into agent profiles\n- **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\n- **noteit_notes_read**: Retrieve complete content of a specific note by its unique ID\n- **noteit_notes_list**: Browse and filter all user notes across projects with optional filtering by tags, record types, or project names\n- **noteit_web_create**: Generate interactive HTML notes to help developers understand complex concepts, processes, or technical details\n- **noteit_flow_create**: Create visual flow diagrams with nested data support for technical process visualization\n\n---\n\n## ⭐ Star this project\n\nIf Noteit MCP helps streamline your AI workflow, please give it a star! It helps others discover this tool and motivates continued development.\n\n## License\n\nMIT\n\n\n",
  "bytes": 5059,
  "sha": "883252f45d780e58e56a44b6d55df06242a93af1c5d29cddb895148167dc3e5e",
  "repo_slug": "bahfahh/noteit-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_bahfahh_noteit_mcp_52bb34b5/readme"
}