note-mcp 1.1.2 → 1.2.0

package/README.md

@@ -40,6 +40,16 @@ Then configure your MCP client without putting cookies in the config:
 }
 ```
 
+Some MCP clients only load newly added tools when a process or conversation starts. After authentication or config changes, restart the client or open a new thread/session if `note_*` tools do not appear immediately.
+
+Quick setup check:
+
+1. `npx note-mcp auth`
+2. `npx note-mcp auth --status`
+3. Add `npx -y note-mcp` to your MCP client config
+4. Restart the client or open a new thread/session
+5. Run `note_auth_status` from the MCP client
+
 ### Servers, containers, and CI
 
 Do not rely on browser login in headless/container environments. Provide a cookie through env or a mounted config file instead:
@@ -102,6 +112,26 @@ Advanced env-based setup:
 }
 ```
 
+### Codex CLI
+
+For Codex, add `note-mcp` as a stdio MCP server with `npx`:
+
+```bash
+codex mcp add note -- npx -y note-mcp
+codex mcp list
+npx -y note-mcp auth --status
+```
+
+Recommended verification flow:
+
+1. `npx note-mcp auth`
+2. `npx note-mcp auth --status`
+3. `codex mcp add note -- npx -y note-mcp`
+4. Restart Codex or create a new thread
+5. Run `note_auth_status`
+
+If the server is listed but `note_*` tools are not available in the current thread, restart Codex or start a new thread so the MCP tools are loaded from the new configuration.
+
 ## Authentication
 
 `note-mcp` supports two authentication paths.
@@ -198,7 +228,7 @@ Authentication/setup tools:
 note.com tools:
 
 - `note_auth_check` — verify configured cookie-based access to note.com internal APIs
-- `note_list_my_notes` — list notes for the authenticated account
+- `note_list_my_notes` — list creator contents for the authenticated account via `GET /v2/creators/info/contents?kind=note&page={page}`. By default returns the full internal API payload. For LLM-friendly list views, pass `fields: "summary"` or `includeBody: false` to return summary fields such as `title`, `key`, `url`, `publishAt`, `status`, and `likeCount`.
 - `note_list_drafts` — list drafts for the authenticated account
 - `note_get_note` — fetch a note by note key, e.g. `n1a0b26f944f4`
 - `note_create_draft` — create a draft
@@ -216,10 +246,12 @@ Known endpoint basis:
 
 - Base URL: `https://note.com/api`
 - Note detail: `GET /v3/notes/{noteKey}`
-- Own contents: `GET /v2/creators/info/contents?kind=note&page=1`
+- Authenticated creator contents: `GET /v2/creators/info/contents?kind=note&page=1`
 - Draft save: `POST /v1/text_notes/draft_save?id={draftId}`
 - Auth smoke test: `GET /v3/notice_counts`
 
+`note_list_my_notes` intentionally exposes the authenticated creator contents endpoint above. The exact visibility and shape are determined by note.com's internal API response for the configured cookie; use the default full response when debugging endpoint behavior, and use summary mode when a compact list is enough.
+
 ## Release
 
 Releases are handled by GitHub Actions + semantic-release.

package/dist/index.js

@@ -131,8 +131,12 @@ var NoteClient = class {
   async authCheck() {
     return this.request("/v3/notice_counts");
   }
-  async listMyNotes(page = 1) {
-    return this.request(`/v2/creators/info/contents?kind=note&page=${page}`);
+  async listMyNotes(page = 1, options = {}) {
+    const payload = await this.request(`/v2/creators/info/contents?kind=note&page=${page}`);
+    if (options.fields === "summary" || options.includeBody === false) {
+      return summarizeListPayload(payload);
+    }
+    return payload;
   }
   async listDrafts(page = 1) {
     return this.request(`/v2/creators/info/contents?kind=draft&page=${page}`);
@@ -181,6 +185,54 @@ var NoteClient = class {
     return body;
   }
 };
+function summarizeListPayload(payload) {
+  if (!isJsonObject(payload)) return payload;
+  if (isJsonObject(payload.data) && Array.isArray(payload.data.contents)) {
+    return {
+      ...payload,
+      data: {
+        ...payload.data,
+        contents: payload.data.contents.map(summarizeNoteItem)
+      }
+    };
+  }
+  if (Array.isArray(payload.contents)) {
+    return {
+      ...payload,
+      contents: payload.contents.map(summarizeNoteItem)
+    };
+  }
+  return payload;
+}
+function summarizeNoteItem(item) {
+  if (!isJsonObject(item)) return item;
+  const key = firstString(item.key, item.noteKey, item.id);
+  return omitUndefined({
+    key,
+    title: firstString(item.title, item.name),
+    url: firstString(item.url, item.noteUrl, item.note_url, item.path) ?? noteUrl(key),
+    publishAt: firstDefined(item.publishAt, item.publish_at, item.publishedAt, item.published_at),
+    status: item.status,
+    likeCount: firstDefined(item.likeCount, item.like_count)
+  });
+}
+function firstDefined(...values) {
+  return values.find((value) => value !== void 0);
+}
+function firstString(...values) {
+  return values.find((value) => typeof value === "string" && value.length > 0);
+}
+function noteUrl(key) {
+  return key ? `https://note.com/notes/${key}` : void 0;
+}
+function omitUndefined(record) {
+  return Object.fromEntries(
+    Object.entries(record).filter((entry) => entry[1] !== void 0)
+  );
+}
+function isJsonObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 async function parseBody(response) {
   const text = await response.text();
   if (!text) return null;
@@ -397,12 +449,14 @@ async function runMcpServer() {
     "note_list_my_notes",
     {
       title: "List my note.com notes",
-      description: "Lists notes for the authenticated note.com account.",
+      description: 'Lists creator contents for the authenticated note.com account via GET /v2/creators/info/contents?kind=note. By default returns the full internal API payload; pass fields: "summary" or includeBody: false for a lightweight list with title/key/url/publishAt/status/likeCount.',
       inputSchema: {
-        page: z.number().int().positive().default(1)
+        page: z.number().int().positive().default(1),
+        fields: z.enum(["full", "summary"]).default("full"),
+        includeBody: z.boolean().optional()
       }
     },
-    async ({ page }) => withClient((client) => client.listMyNotes(page))
+    async ({ page, fields, includeBody }) => withClient((client) => client.listMyNotes(page, { fields, includeBody }))
   );
   server.registerTool(
     "note_list_drafts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "note-mcp",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "description": "Unofficial stdio MCP server for note.com using cookie-based internal APIs.",
   "type": "module",
   "bin": {