bear_create_note

Instructions

Implementation Reference

• mcp-server/src/tools.ts:147-198 (registration)

  Registration of the bear_create_note tool as part of the tools registry, exported from tools.ts and consumed by index.ts

  bear_create_note: {
    tool: {
      name: "bear_create_note",
      description:
        "Create a new Bear note with a title, optional body text, tags, and YAML front matter. Hashtags written inline in the body (e.g. '#my_tag' or '#parent/child') are extracted and registered as real tags on the note, matching Bear's desktop-app behaviour. Tags from the 'tags' array are indexed regardless of whether they appear in the body. Hierarchical tags like '#parent/child' also index every ancestor (so they show up under #parent in Bear's sidebar). Front matter is stored as a collapsed metadata block at the top of the note. Returns the new note's ID.",
      inputSchema: {
        type: "object" as const,
        properties: {
          title: {
            type: "string",
            description: "Note title",
          },
          body: {
            type: "string",
            description: "Note body text (markdown)",
          },
          tags: {
            type: "array",
            items: { type: "string" },
            description: "Tags to assign to the note",
          },
          frontmatter: {
            type: "object",
            description:
              "YAML front matter fields as key-value pairs (e.g. {status: 'draft', project: 'alpha'})",
            additionalProperties: { type: "string" },
          },
        },
        required: ["title"],
      },
      annotations: {
        readOnlyHint: false,
        destructiveHint: false,
        idempotentHint: false,
      },
    },
    buildArgs: (input) => {
      const args = ["create", String(input.title), "--json"];
      if (input.body) args.push("--body", String(input.body));
      if (Array.isArray(input.tags) && input.tags.length > 0) {
        args.push("--tags", input.tags.join(","));
      }
      if (input.frontmatter && typeof input.frontmatter === "object") {
        const fm = input.frontmatter as Record<string, string>;
        args.push(
          "--fm",
          ...Object.entries(fm).map(([k, v]) => `${k}=${v}`),
        );
      }
      return args;
    },
  },

• mcp-server/src/tools.ts:152-176 (schema)

  Input schema for bear_create_note: title (required), body (optional), tags (optional string array), frontmatter (optional string-string object)

  inputSchema: {
    type: "object" as const,
    properties: {
      title: {
        type: "string",
        description: "Note title",
      },
      body: {
        type: "string",
        description: "Note body text (markdown)",
      },
      tags: {
        type: "array",
        items: { type: "string" },
        description: "Tags to assign to the note",
      },
      frontmatter: {
        type: "object",
        description:
          "YAML front matter fields as key-value pairs (e.g. {status: 'draft', project: 'alpha'})",
        additionalProperties: { type: "string" },
      },
    },
    required: ["title"],
  },

• mcp-server/src/tools.ts:183-197 (handler)

  Handler logic: builds CLI arguments for 'bcli create' command with optional --body, --tags, and --fm flags based on input parameters

  buildArgs: (input) => {
    const args = ["create", String(input.title), "--json"];
    if (input.body) args.push("--body", String(input.body));
    if (Array.isArray(input.tags) && input.tags.length > 0) {
      args.push("--tags", input.tags.join(","));
    }
    if (input.frontmatter && typeof input.frontmatter === "object") {
      const fm = input.frontmatter as Record<string, string>;
      args.push(
        "--fm",
        ...Object.entries(fm).map(([k, v]) => `${k}=${v}`),
      );
    }
    return args;
  },

• mcp-server/src/index.ts:29-31 (registration)

  MCP server registration: all tools (including bear_create_note) are listed via ListToolsRequestSchema and invoked via CallToolRequestSchema, which looks up the tool by name from the tools registry

  server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: Object.values(tools).map((t) => t.tool),
  }));