Bear App MCP Server

Instructions

Implementation Reference

• src/index.ts:911-929 (handler)

  The main handler function for the 'bear_trash_note' tool. It builds a Bear x-callback URL with action 'trash' using the provided note ID or search term, executes it, and returns a success message.

  private async trashNote(args: any) {
    const params: Record<string, string | boolean> = {};
    
    if (args.id) params.id = args.id;
    if (args.search) params.search = args.search;
    if (args.show_window) params.show_window = "yes";
  
    const url = this.buildBearURL("trash", params);
    await this.executeURL(url);
  
    return {
      content: [
        {
          type: "text",
          text: `Moved note(s) to trash${args.id ? ` with ID: ${args.id}` : args.search ? ` matching: ${args.search}` : ""}`
        }
      ]
    };
  }

• src/index.ts:511-527 (schema)

  Input schema for the bear_trash_note tool, defining optional parameters: id (string), search (string), show_window (boolean).

  inputSchema: {
    type: "object",
    properties: {
      id: {
        type: "string",
        description: "Note unique identifier"
      },
      search: {
        type: "string",
        description: "Search term to find notes to trash"
      },
      show_window: {
        type: "boolean",
        description: "Show Bear window"
      }
    }
  }

• src/index.ts:508-528 (registration)

  Tool registration in the listTools response, including name, description, and input schema.

  {
    name: "bear_trash_note",
    description: "Move a note to trash",
    inputSchema: {
      type: "object",
      properties: {
        id: {
          type: "string",
          description: "Note unique identifier"
        },
        search: {
          type: "string",
          description: "Search term to find notes to trash"
        },
        show_window: {
          type: "boolean",
          description: "Show Bear window"
        }
      }
    }
  },

• src/index.ts:719-720 (registration)

  Dispatch registration in the CallToolRequest handler switch statement, mapping the tool name to the trashNote method.

  case "bear_trash_note":
    return await this.trashNote(args);