| name | siyuan-mcp-database |
| description | MCP playbook for SiYuan attribute views. Use to inspect database metadata, render views, add columns or rows, update cells, and keep AV, view, row, column, and block IDs distinct. |
Operate SiYuan Databases with MCP
Never guess attribute-view identifiers. Inspect the AV and its views before changing rows or cells.
av(action="get", id="<av-id>")
av(action="render", id="<av-id>", page=1, pageSize=50)
av(action="search", keyword="project")
Keep these identifiers distinct: AV ID identifies the database; view ID identifies a table/board view; row ID identifies a key value; column ID identifies a key; block ID identifies note content.
Mutations
av(action="add_column", avID="<av-id>", keyName="Status", keyType="select")
av(action="add_rows", avID="<av-id>", viewID="<view-id>", blockIDs=["<block-id>"])
av(action="set_cells", avID="<av-id>", cells=[{"rowID":"<row-id>","columnID":"<column-id>","valueType":"text","text":"Done"}])
Before writing cells, render the current view and map column names to column IDs. Preserve the declared value type; do not put a date-shaped string into a number/date/select column without using the action’s expected value shape. Re-render after mutation. Read siyuan://help/action/av/set_cells for the current cell schema.
