add_note
Create and organize notes in a markdown knowledge base using hierarchical categories and tags for structured information storage.
Instructions
Create a new note in the knowledge base (supports hierarchical categories)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| category_path | Yes | Category path (e.g., 'work', 'work/clients/acme', 'personal/spiritual'). Category will be created if it doesn't exist. | |
| title | Yes | Note title (becomes filename) | |
| content | Yes | Markdown content of the note | |
| tags | No | Comma-separated tags (optional) |
Implementation Reference
- src/knowledge_base_mcp/server.py:410-441 (handler)The handler function that executes the 'add_note' tool logic: parses arguments, invokes storage.create_note, formats success/error responses.async def handle_add_note(arguments: dict) -> list[TextContent]: """Handle add_note tool call.""" try: category_path = arguments["category_path"] title = arguments["title"] content = arguments["content"] tags_str = arguments.get("tags", "") # Parse tags tags = [tag.strip() for tag in tags_str.split(",") if tag.strip()] # Create note (will auto-create category if needed) note = storage.create_note( category_path=category_path, title=title, content=content, tags=tags, create_category=True ) filename = storage.sanitize_filename(title) result = f"✓ Note '{title}' created in {category_path or 'root'}/\n" result += f" File: {filename}.md\n" if tags: result += f" Tags: {', '.join(tags)}" return [TextContent(type="text", text=result)] except (DuplicateNoteError, CategoryNotFoundError, InvalidPathError, StorageError) as e: return [TextContent(type="text", text=str(e))] except Exception as e: return [TextContent(type="text", text=f"❌ Error: {str(e)}")]
- Input schema and description for the 'add_note' tool, defining parameters and validation rules.Tool( name="add_note", description="Create a new note in the knowledge base (supports hierarchical categories)", inputSchema={ "type": "object", "properties": { "category_path": { "type": "string", "description": "Category path (e.g., 'work', 'work/clients/acme', 'personal/spiritual'). Category will be created if it doesn't exist.", }, "title": { "type": "string", "description": "Note title (becomes filename)", }, "content": { "type": "string", "description": "Markdown content of the note", }, "tags": { "type": "string", "description": "Comma-separated tags (optional)", "default": "", }, }, "required": ["category_path", "title", "content"], }, ),
- src/knowledge_base_mcp/server.py:138-164 (registration)The 'add_note' tool is registered here within the list_tools() handler by including its Tool object.Tool( name="add_note", description="Create a new note in the knowledge base (supports hierarchical categories)", inputSchema={ "type": "object", "properties": { "category_path": { "type": "string", "description": "Category path (e.g., 'work', 'work/clients/acme', 'personal/spiritual'). Category will be created if it doesn't exist.", }, "title": { "type": "string", "description": "Note title (becomes filename)", }, "content": { "type": "string", "description": "Markdown content of the note", }, "tags": { "type": "string", "description": "Comma-separated tags (optional)", "default": "", }, }, "required": ["category_path", "title", "content"], }, ),
- Supporting storage method invoked by the handler to create the note file, handle sanitization, frontmatter, and filesystem persistence.def create_note( self, category_path: str, title: str, content: str, tags: list[str], metadata: Optional[dict] = None, create_category: bool = True ) -> Note: """ Create a new note. Args: category_path: Category path (e.g., "work/clients/acme") title: Note title content: Markdown content tags: List of tags metadata: Additional metadata fields create_category: If True, create category if it doesn't exist Returns: Created Note object Raises: DuplicateNoteError: If note already exists InvalidPathError: If category path is invalid StorageError: If write fails """ # Normalize and validate path normalized = normalize_path(category_path) is_valid, error_msg = validate_path(normalized) if normalized else (True, None) if not is_valid: raise InvalidPathError(error_msg) # Create category if needed if normalized and not self._category_exists(normalized): if create_category: self.create_category(normalized, create_parents=True) else: raise CategoryNotFoundError( f"❌ Error: Category '{normalized}' does not exist\n" f"💡 Tip: Use create_category first or set create_category=True" ) file_path = self._get_note_path(normalized, title) if file_path.exists(): raise DuplicateNoteError( f"❌ Error: Note '{title}' already exists in {normalized or 'root'}/\n" f"💡 Tip: Use update_note to modify existing notes" ) # Create frontmatter frontmatter = NoteFrontmatter( tags=tags, category=normalized, metadata=metadata or {} ) # Create note object note = Note( title=title, category=normalized, frontmatter=frontmatter, content=content, file_path=str(file_path) ) # Write to file self._write_note_file(note, file_path, backup=False) return note