# noteit-mcp

Create project notes, tasks, and issues enriched with Mermaid diagrams, interactive flows, and rich HTML explainers. Generate and organize reusable profiles and configuration components to guide beha…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add bahfahh/noteit-mcp

# Browse available tools
npx -y smithery tool list bahfahh/noteit-mcp

# Get full schema for a tool
npx -y smithery tool get bahfahh/noteit-mcp noteit_profiles_list

# Call a tool
npx -y smithery tool call bahfahh/noteit-mcp noteit_profiles_list '{}'
```

## Direct MCP Connection

Endpoint: `https://noteit-mcp--bahfahh.run.tools`

## Tools (8)

- `noteit_profiles_list` — List user agent profiles - configuration sets for AI behavior. When using profiles with personas, adopt their character…
- `noteit_profiles_getConfig` — GET AGENT CONFIGURATION: Retrieve a composable AI agent configuration profile containing personas, instructions, rules,…
- `noteit_profiles_generate` — CREATE AGENT CONFIGURATION COMPONENTS: Generate and save individual configuration components (persona, rule, document, …
- `noteit_notes_create` — Create notes with Mermaid diagram support. IMPORTANT: title ≠ projectName. title = specific note title/name, projectNam…
- `noteit_notes_read` — Read a specific note by ID
- `noteit_notes_list` — List user notes with optional tag and project filtering. Use 'projectName' to filter by project, or omit for cross-proj…
- `noteit_web_create` — Generate interactive HTML notes to help developers UNDERSTAND complex concepts, processes, or technical details. This i…
- `noteit_flow_create` — Create visual flow diagrams with NESTED DATA SUPPORT for ANY technical process visualization. Use this for: debugging f…

```bash
# Get full input/output schema for a tool
npx -y smithery tool get bahfahh/noteit-mcp <tool-name>
```

## Resources

- `noteit://about` — Easy-to-understand guide showing real developer workflows and usage examples for AI agent configuration and project doc…
- `manual://noteit-mcp/tools-guide` — Comprehensive guide covering all 8 MCP tools with usage examples, common errors, and best practices