Weavers / MCP documentation

Find your notebooks

Get notebook titles and identifiers from your account.

Read onlylist_my_notebooks

Required permission: weavers.notebooks.read

Try asking

Show me my five most recently updated Weavers notebooks.

How it works

Returns up to 50 entries; the default is 20. There is no cursor or next page.
Saved notebooks are ordered by update time. If the default Research Notebook has not been saved, it is included first with null timestamps.
Notebook content is not included. Titles are capped at 200 characters.

Inputs

Field	Required	Type & constraints
limit	Optional	integer; minimum 1; maximum 50; default 20

View complete input JSON schema

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "additionalProperties": false
}

What comes back

Field	Description
notebooks[]	Array of notebook summaries.
notebookKey, title	Strings. Notebook identifier and display title.
savedAt, createdAt, updatedAt	ISO timestamp strings or null for the unsaved default notebook.

This table describes the decoded tool result. MCP wraps it in text content and, for object results, structuredContent.

Worked example

Fictional data. Replace identifiers, revisions and hashes with values from your own Weavers workflow.

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_my_notebooks",
    "arguments": {
      "limit": 5
    }
  }
}

Decoded result

{
  "notebooks": [
    {
      "notebookKey": "research",
      "title": "Research Notebook",
      "savedAt": null,
      "createdAt": null,
      "updatedAt": null
    }
  ]
}

If the request fails

Sign in and grant weavers.notebooks.read before calling this tool.
Use resources you can access and refresh revision information when it changes.
Check result.isError even when HTTP returns 200.

Find the error and next step →