bear_get_untagged

Retrieve notes without tags from Bear App to organize and manage untagged content efficiently.

Instructions

Get untagged notes

Input Schema

TableJSON Schema

Name	Required	Description
`search`	No	Search term
`token`	No	Bear API token
`show_window`	No	Show Bear window

Implementation Reference

src/index.ts:951-971 (handler)

The handler function that implements the core logic for the 'bear_get_untagged' tool. It constructs parameters from input args, calls Bear's 'untagged' x-callback-url via executeWithCallback, processes the returned data, and formats it as MCP content.

private async getUntagged(args: any) {
  const params: Record<string, string | boolean> = {};
  
  if (args.search) params.search = args.search;
  if (args.token) params.token = args.token;
  if (args.show_window) params.show_window = "yes";

  const untaggedData = await this.executeWithCallback("untagged", params);

  return {
    content: [
      {
        type: "text",
        text: JSON.stringify({
          message: `Retrieved untagged notes${args.search ? ` matching: ${args.search}` : ""}`,
          notes: untaggedData
        }, null, 2)
      }
    ]
  };
}

src/index.ts:550-570 (schema)

Input schema definition for the 'bear_get_untagged' tool, specifying optional properties for search term, API token, and window visibility.

{
  name: "bear_get_untagged",
  description: "Get untagged notes",
  inputSchema: {
    type: "object",
    properties: {
      search: {
        type: "string",
        description: "Search term"
      },
      token: {
        type: "string",
        description: "Bear API token"
      },
      show_window: {
        type: "boolean",
        description: "Show Bear window"
      }
    }
  }
},

src/index.ts:723-724 (registration)
Switch case registration that maps the tool name 'bear_get_untagged' to its handler function within the CallToolRequestSchema handler.
```
case "bear_get_untagged":
  return await this.getUntagged(args);
```

src/index.ts:550-570 (registration)

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

{
  name: "bear_get_untagged",
  description: "Get untagged notes",
  inputSchema: {
    type: "object",
    properties: {
      search: {
        type: "string",
        description: "Search term"
      },
      token: {
        type: "string",
        description: "Bear API token"
      },
      show_window: {
        type: "boolean",
        description: "Show Bear window"
      }
    }
  }
},

Bear App MCP Server