Skip to main content
Glama

Roam Research MCP Server

by mickm3n
1
  • Apple

get_page_references

Retrieve blocks referencing a specific Roam Research page, sorted by recency, with full hierarchical context and pagination support for large datasets.

Instructions

Get all blocks that reference a specific page in Roam Research with pagination support.

Finds all blocks across your Roam database that contain links to the specified page.
Results are sorted by most recent edit time and include the full hierarchical context
of each referencing block.

Args:
    page_name: Exact name of the page to find references for (case-sensitive)
    limit: Maximum number of references to return per request (default: 10)
    cursor: Timestamp cursor for pagination - use next_cursor from previous response
           to get additional results
           
Returns:
    JSON string containing:
    - result: Array of referencing blocks with content and timestamps  
    - next_cursor: Timestamp for pagination (if more results available)
    - total_matches: Number of references found in this batch
    
Examples:
    get_page_references("GTD")
    get_page_references("Project Alpha", limit=20)
    get_page_references("Meeting Notes", limit=5, cursor=1640995200000)

Input Schema

NameRequiredDescriptionDefault
cursorNo
limitNo
page_nameYes

Input Schema (JSON Schema)

{ "properties": { "cursor": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "default": null, "title": "Cursor" }, "limit": { "default": 10, "title": "Limit", "type": "integer" }, "page_name": { "title": "Page Name", "type": "string" } }, "required": [ "page_name" ], "title": "get_page_referencesArguments", "type": "object" }

Other Tools from Roam Research MCP Server

Related Tools

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mickm3n/roam-research-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server