note.com MCP Server

Instructions

Implementation Reference

• src/tools/user-tools.ts:46-65 (handler)

  The main handler function for 'get-user-notes' tool. Fetches user's notes from note.com API endpoint `/v2/creators/${username}/contents?kind=note&page=${page}`, formats each note using formatNote, and returns total count, limit, and list of formatted notes.

  async ({ username, page }) => {
    try {
      const data = await noteApiRequest(`/v2/creators/${username}/contents?kind=note&page=${page}`);
  
      let formattedNotes: any[] = [];
      if (data.data && data.data.contents) {
        formattedNotes = data.data.contents.map((note: any) => 
          formatNote(note, username)
        );
      }
  
      return createSuccessResponse({
        total: data.data?.totalCount || 0,
        limit: data.data?.limit || 0,
        notes: formattedNotes
      });
    } catch (error) {
      return handleApiError(error, "ユーザー記事一覧取得");
    }
  }

• src/tools/user-tools.ts:42-45 (schema)

  Input schema defined with Zod: username (required string), page (optional number, defaults to 1).

  {
    username: z.string().describe("ユーザー名"),
    page: z.number().default(1).describe("ページ番号"),
  },

• src/tools/user-tools.ts:39-66 (registration)

  Direct registration of the 'get-user-notes' tool using server.tool() method, including name, Japanese description, input schema, and handler function.

  server.tool(
    "get-user-notes",
    "ユーザーの記事一覧を取得する",
    {
      username: z.string().describe("ユーザー名"),
      page: z.number().default(1).describe("ページ番号"),
    },
    async ({ username, page }) => {
      try {
        const data = await noteApiRequest(`/v2/creators/${username}/contents?kind=note&page=${page}`);
  
        let formattedNotes: any[] = [];
        if (data.data && data.data.contents) {
          formattedNotes = data.data.contents.map((note: any) => 
            formatNote(note, username)
          );
        }
  
        return createSuccessResponse({
          total: data.data?.totalCount || 0,
          limit: data.data?.limit || 0,
          notes: formattedNotes
        });
      } catch (error) {
        return handleApiError(error, "ユーザー記事一覧取得");
      }
    }
  );

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

  Higher-level registration call that invokes registerUserTools(server), which includes the 'get-user-notes' tool.

  registerUserTools(server);