get_page_references

Retrieve all blocks referencing a specific Roam Research page with pagination. Returns hierarchical context, timestamps, and enables efficient batch processing for extensive databases.

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

Name	Required	Description	Default
`cursor`	No
`limit`	No
`page_name`	Yes

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"
}

Roam Research MCP Server

get_page_references

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Roam Research MCP Server

Related Tools

MCP directory API