MCP Kibela

Instructions

Implementation Reference

• src/tools/createNote.ts:61-87 (handler)

  The handler function for 'kibela_create_note' tool that validates required parameters and calls the GraphQL 'createNote' mutation to create the note.

  handler: async ({ title, content, groupIds, folders, authorId, coediting, draft }) => {
    if (!title || !content || !groupIds || !coediting) {
      throw new Error('Title, content, groupIds, and coediting are required')
    }
  
    const response = await createNote({
      input: {
        clientMutationId: uuid(),
        title,
        content,
        groupIds,
        folders,
        authorId,
        coediting,
        draft,
      },
    })
  
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(response.createNote, null, 2),
        },
      ],
    }
  },

• src/tools/createNote.ts:16-60 (schema)

  The tool definition including name, description, and input schema for parameter validation.

  tool: {
    name: 'kibela_create_note',
    description: 'Create a new note in Kibela.',
    inputSchema: {
      type: 'object',
      properties: {
        title: {
          type: 'string',
          description: 'required: Title of the note',
        },
        content: {
          type: 'string',
          description: 'required: Content of the note in markdown format',
        },
        groupIds: {
          type: 'array',
          items: {
            type: 'string',
          },
          description: 'required: IDs of the groups to create the note in.',
        },
        folders: {
          type: 'array',
          items: {
            type: 'string',
          },
          description: 'IDs of the folders to add the note to.',
        },
        authorId: {
          type: 'string',
          description:
            'ID of the author of the note. If not specified, the note will be created by the authenticated user.',
        },
        coediting: {
          type: 'boolean',
          description: 'required: Whether to enable co-editing for the note',
        },
        draft: {
          type: 'boolean',
          description: 'Whether to create the note as a draft',
        },
      },
      required: ['title', 'content'],
    },
  },

• src/tools/index.ts:9-16 (registration)

  Registration of the 'kibela_create_note' tool by mapping it to createNoteTool in the toolDefinitions object.

  const toolDefinitions = {
    kibela_search_notes: searchNotesTool,
    kibela_get_my_notes: getMyNotesTool,
    kibela_get_note_content: getNoteContentTool,
    kibela_get_note_from_path: getNoteFromPathTool,
    kibela_update_note_content: updateNoteContentTool,
    kibela_create_note: createNoteTool,
  } as const

• src/graphql/queries/createNote.ts:30-46 (helper)

  GraphQL mutation definition and helper function used by the tool handler to perform the actual note creation.

  const createNoteMutation: TypedDocumentNode<CreateNoteResponse, CreateNoteVariables> = gql`
    mutation CreateNote($input: CreateNoteInput!) {
      createNote(input: $input) {
        clientMutationId
        note {
          id
          title
          content
          url
        }
      }
    }
  `
  
  export async function createNote(variables: CreateNoteVariables): Promise<CreateNoteResponse> {
    return gqlRequest(createNoteMutation, variables)
  }