Sidvy
Sidvy is a note-taking system accessed via MCP.
Quick Reference
Native MCP (Claude Code): Call tools directly as sidvy.<tool>(args)
OpenClaw: Use mcporter call sidvy.<tool> [args]
Notes
- •
list_notes— List/filter notes (workspaceId?, groupId?, search?, limit?) - •
create_note— Create note (name, content?, workspaceId?, groupId?) - •
update_note— Update note (id, name?, content?, groupId?) - •
delete_note— Soft delete (id) - •
get_note— Get by ID (id, workspaceId?) - •
search_notes— Full-text search (query, workspaceId?, limit?) - •
get_recent_notes— Recently updated (workspaceId?, limit?) - •
append_to_note— Append content (id, content, workspaceId?)
Calendar Notes (Daily/Weekly)
- •
get_daily_note— Get today's note or specific date (date?, workspaceId?) - •
update_daily_note— Update daily note content (content, date?, workspaceId?) - •
append_to_daily_note— Append to daily note (content, date?, workspaceId?) - •
get_weekly_note— Get current/specific week note (week?, year?, workspaceId?) - •
update_weekly_note— Update weekly note content (content, week?, year?, workspaceId?) - •
append_to_weekly_note— Append to weekly note (content, week?, year?, workspaceId?)
Groups
- •
list_groups— List groups (workspaceId?, parentId?, search?) - •
create_group— Create group (name, workspaceId?, parentId?) - •
update_group— Update group (groupId, name?, parentId?) - •
delete_group— Delete group and children (groupId) - •
get_group_tree— Full hierarchy (workspaceId) - •
get_root_groups— Top-level groups (workspaceId?) - •
get_child_groups— Children of a group (parentId, workspaceId?) - •
get_group_path— Path from root to group (groupId, workspaceId) - •
move_group— Move to new parent (groupId, newParentId?) - •
create_group_path— Create nested path (path[], workspaceId?)
Todos
- •
list_todos— List/filter todos (workspaceId?, noteId?, completed?) - •
create_todo— Create todo (text, noteId, lineNumber, completed?) - •
create_todos_for_note— Bulk create todos (noteId, todoTexts[], startingLineNumber?, workspaceId?) - •
update_todo— Update todo (todoId, text?, completed?, lineNumber?) - •
delete_todo— Delete todo (todoId) - •
toggle_todo— Toggle completion (todoId) - •
complete_todo/uncomplete_todo— Set status (todoId) - •
get_pending_todos— Incomplete todos (workspaceId?, limit?) - •
get_completed_todos— Completed todos (workspaceId?, limit?) - •
get_todos_for_note— Todos in a note (noteId, workspaceId?) - •
get_todo_stats— Completion statistics (workspaceId?) - •
search_todos— Search todos by text (query, workspaceId?)
Workspaces
- •
list_workspaces— List all workspaces (includeStats?) - •
create_workspace— Create workspace (name) — max 2 per user - •
update_workspace— Update workspace (workspaceId, name?) - •
delete_workspace— Delete workspace (workspaceId, confirmDelete) — cannot delete default - •
rename_workspace— Rename workspace (workspaceId, newName) - •
get_workspace— Get workspace details (workspaceId) - •
get_workspace_by_name— Find workspace by name (name) - •
get_default_workspace— Get default workspace - •
get_workspace_stats— Content statistics (workspaceId?) - •
can_create_workspace— Check if can create another workspace - •
switch_workspace— Change active workspace (workspaceId)
Examples
bash
# List recent notes mcporter call sidvy.get_recent_notes limit=5 # Create a note in a group mcporter call sidvy.create_note name="Meeting Notes" content="# Agenda\n- Item 1" groupId="abc-123" # Search notes mcporter call sidvy.search_notes query="project planning" # Get pending todos mcporter call sidvy.get_pending_todos # Toggle a todo mcporter call sidvy.toggle_todo todoId="todo-456" # Get today's daily note (creates if not exists) mcporter call sidvy.get_daily_note # Get specific date's daily note mcporter call sidvy.get_daily_note date="2025-02-01" # Append to today's daily note mcporter call sidvy.append_to_daily_note content="## Meeting at 3pm\n- Discussed roadmap" # Get current week's note mcporter call sidvy.get_weekly_note # Get specific week's note mcporter call sidvy.get_weekly_note week=5 year=2025 # Update weekly note mcporter call sidvy.update_weekly_note content="## Week Summary\n- Completed API work"
Notes
- •Content is markdown format
- •Todos sync with markdown checkboxes in notes
- •Groups support hierarchical nesting
- •Default workspace used when workspaceId omitted
- •For full tool schemas:
mcporter list sidvy --schema