feat: add Open Notebook search MCP command to Agent Zero

[POWERFULMOVES]

Summary

• add a notebook.search MCP command that calls the Open Notebook API and returns curated summaries
• expose Open Notebook configuration in the Agent Zero FastAPI schema and document the new command
• document operator usage of notebook search, including environment variables and curl example

Testing

• python -m compileall pmoves/services/agent-zero

---

https://chatgpt.com/codex/tasks/task_b_68f3d1cfd154832481a19c3ab1a2863f

Summary by CodeRabbit

• New Features

  • Added notebook search functionality through MCP command with filtering options by notebook ID, tags, and source IDs.
  • Enhanced search results with summaries and pagination support.

• Documentation

  • Updated configuration documentation with required Open Notebook API environment variables.
  • Added instructions for invoking notebook search operations.

[coderabbitai]

Warning

Rate limit exceeded

@POWERFULMOVES has exceeded the limit for the number of commits or files that can be reviewed per hour. Please wait 18 minutes and 3 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

📥 Commits

Reviewing files that changed from the base of the PR and between 93e919c and d294510.

📒 Files selected for processing (1)

• pmoves/docs/LOCAL_TOOLING_REFERENCE.md (1 hunks)

Walkthrough

Open Notebook API integration is added across documentation, configuration, and MCP server layers. Configuration extends to support API credentials and workspace settings. A new notebook.search MCP command is implemented with credential validation, filtering, and response transformation capabilities.

Changes

Cohort / File(s)	Summary
Documentation Updates pmoves/docs/LOCAL_TOOLING_REFERENCE.md, pmoves/services/agent-zero/README.md	Added documentation for the notebook.search MCP command and Open Notebook API configuration parameters (OPEN_NOTEBOOK_API_URL, OPEN_NOTEBOOK_API_TOKEN, OPEN_NOTEBOOK_WORKSPACE with fallback aliases).
Configuration Extension pmoves/services/agent-zero/main.py	Extended AgentZeroServiceConfig with three new optional fields: open_notebook_api_url, open_notebook_workspace, and open_notebook_token_present. Updated load_service_config() to populate these from environment variables with fallback support.
Notebook Search Implementation pmoves/services/agent-zero/mcp_server.py	Implemented notebook_search() function with credential validation, payload composition (query, filters, limit, workspace, notebook_id, source_ids, tags), API integration, response transformation, and error handling. Added helper function _summarize_note() for generating note summaries. Registered new "notebook.search" command in MCP dispatcher.

Sequence Diagram

sequenceDiagram
    participant Client as MCP Client
    participant Server as MCP Server
    participant Dispatcher as Command Dispatcher
    participant Handler as notebook_search()
    participant OpenNotebook as Open Notebook API
    
    Client->>Server: Execute notebook.search command
    Server->>Dispatcher: Route to handler
    Dispatcher->>Handler: Call with payload
    
    rect rgba(255, 200, 100, 0.2)
        Note over Handler: Credential Validation
        Handler->>Handler: Check NOTEBOOK_API_URL<br/>Check NOTEBOOK_API_TOKEN
    end
    
    rect rgba(200, 255, 200, 0.2)
        Note over Handler: Payload Validation
        Handler->>Handler: Validate query/filters<br/>Validate limit parameter
    end
    
    rect rgba(100, 200, 255, 0.2)
        Note over Handler: API Call
        Handler->>OpenNotebook: POST with composed payload<br/>(query, filters, workspace, etc.)
        OpenNotebook-->>Handler: Return notes + cursor
    end
    
    rect rgba(200, 200, 255, 0.2)
        Note over Handler: Response Transform
        Handler->>Handler: Transform notes structure<br/>Summarize note content<br/>Shape response
    end
    
    Handler-->>Dispatcher: Return structured response
    Dispatcher-->>Server: Send to client
    Server-->>Client: MCP response

Loading

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~60 minutes

The changes introduce a new API integration feature spanning multiple layers. The mcp_server.py implementation is logic-dense with credential handling, payload composition, API communication, response transformation, and error handling. Configuration modifications require understanding of environment variable fallback patterns. Documentation changes are minimal effort but context-dependent. The heterogeneous nature of changes across different file types and functionality domains necessitates careful review of each component.

Poem

🐰 A notebook search command hops into place,
With credentials configured, API strings embrace,
The Open Notebook realm we now shall explore,
Through MCP's dispatch, results by the score,
Our fuzzy friend searches with queries and grace! 📖✨

---

Note

🎁 Summarized by CodeRabbit Free

Your organization is on the Free plan. CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please upgrade your subscription to CodeRabbit Pro by visiting https://app.coderabbit.ai/login.

_{Comment @coderabbitai help to get the list of available commands and usage tips.}