# Notion: ツールの説明文の採点結果

- tools/list の取得日: 2026-09-30 (UTC)
- 出どころ: [npm @notionhq/notion-mcp-server@1.0.0](https://www.npmjs.com/package/@notionhq/notion-mcp-server)
- ホームページ: https://github.com/makenotion/notion-mcp-server
- 採点の規則: v2
- ツール: 24
- 平均点: 33.0 / 100 (雨)
- ほぼ同じ説明の組: 57

このページには、Notion のツールの説明文の点数と指摘、ツールと引数の名前を載せています。説明文はサーバーのものなので、出どころのページでお読みください。

## サーバー全体

- 軽微: 説明がほぼ同じ組は全部で 57 組あります（上位 12 組を表示）。
- 軽微: サーバーに instructions がありません。何のためのサーバーで、いつ使うかを、そこに 1 回だけ書いてください。Claude Code と Gemini CLI は、ツールの説明より先に instructions を読みます。

## ツール

- `API-query-data-source`: 20 / 100
  - 要対応: 説明文が名前の言い換えになっています（9 語）。
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 要対応: 説明のない引数: filter、sorts、start_cursor、page_size、archived、in_trash
  - 軽微: 制約も例もない文字列の引数: start_cursor
  - 軽微: 引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。
  - 軽微: 真偽値の引数 archived の意味が分かりにくくなっています。
  - 軽微: 真偽値の引数 in_trash の意味が分かりにくくなっています。
  - 軽微: 何が返るかが書かれていません。
  - 軽微: 必須の id 系の引数に、値をどこから得るかが書かれていません: data_source_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。
- `API-create-a-comment`: 24 / 100
  - 要対応: 説明文が短すぎます（7 語）。
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 要対応: 説明のない引数: parent、rich_text、rich_text[].text
  - 軽微: 引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。
  - 軽微: 何が返るかが書かれていません。
  - 軽微: 必須の id 系の引数に、値をどこから得るかが書かれていません: parent。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。
- `API-update-a-data-source`: 24 / 100
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 要対応: 説明のない引数: title、description、properties
  - 軽微: 引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。
  - 軽微: 何が返るかが書かれていません。
  - 軽微: 必須の id 系の引数に、値をどこから得るかが書かれていません: data_source_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。
- `API-create-a-data-source`: 25 / 100
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 要対応: 説明のない引数: parent、properties、title
  - 軽微: 引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。
  - 軽微: 何が返るかが書かれていません。
  - 軽微: 必須の id 系の引数に、値をどこから得るかが書かれていません: parent。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。
- `API-get-user`: 25 / 100
  - 要対応: 説明文が短すぎます（6 語）。
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 要対応: 説明のない引数: user_id
  - 軽微: 何が返るかが書かれていません。
  - 軽微: 必須の id 系の引数に、値をどこから得るかが書かれていません: user_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。
- `API-list-data-source-templates`: 25 / 100
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 要対応: 説明のない引数: start_cursor、page_size
  - 軽微: 制約も例もない文字列の引数: start_cursor
  - 軽微: 引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。
  - 軽微: 何が返るかが書かれていません。
  - 軽微: 必須の id 系の引数に、値をどこから得るかが書かれていません: data_source_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。
- `API-patch-page`: 25 / 100
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 要対応: 説明のない引数: properties、archived、icon、cover
  - 軽微: 真偽値の引数 archived の意味が分かりにくくなっています。
  - 軽微: 何が返るかが書かれていません。
  - 軽微: 必須の id 系の引数に、値をどこから得るかが書かれていません: page_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。
- `API-move-page`: 29 / 100
  - 要対応: 説明文が名前の言い換えになっています（8 語）。
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 軽微: 説明のない引数: parent
  - 軽微: 何が返るかが書かれていません。
  - 軽微: 必須の id 系の引数に、値をどこから得るかが書かれていません: page_id、parent。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。
- `API-update-a-block`: 30 / 100
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 軽微: 説明のない引数: type
  - 軽微: 引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。
  - 軽微: 何が返るかが書かれていません。
  - 軽微: 必須の id 系の引数に、値をどこから得るかが書かれていません: block_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。
- `API-post-page`: 34 / 100
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 軽微: 説明のない引数: parent、properties
  - 軽微: 引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。
  - 軽微: 何が返るかが書かれていません。
  - 軽微: 必須の id 系の引数に、値をどこから得るかが書かれていません: parent。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。
- `API-post-search`: 34 / 100
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 軽微: 説明のない引数: sort、filter
  - 軽微: 引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。
  - 軽微: 何が返るかが書かれていません。
- `API-delete-a-block`: 35 / 100
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 軽微: 何が返るかが書かれていません。
  - 軽微: 必須の id 系の引数に、値をどこから得るかが書かれていません: block_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。
- `API-get-block-children`: 35 / 100
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 軽微: 引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。
  - 軽微: 何が返るかが書かれていません。
  - 軽微: 必須の id 系の引数に、値をどこから得るかが書かれていません: block_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。
- `API-get-users`: 35 / 100
  - 要対応: 説明文が短すぎます（6 語）。
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 軽微: 何が返るかが書かれていません。
- `API-patch-block-children`: 35 / 100
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 軽微: 何が返るかが書かれていません。
  - 軽微: 必須の id 系の引数に、値をどこから得るかが書かれていません: block_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。
- `API-retrieve-a-block`: 35 / 100
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 軽微: 何が返るかが書かれていません。
  - 軽微: 必須の id 系の引数に、値をどこから得るかが書かれていません: block_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。
- `API-retrieve-a-comment`: 35 / 100
  - 要対応: 説明文が短すぎます（7 語）。
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 軽微: 引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。
  - 軽微: 何が返るかが書かれていません。
  - 軽微: 必須の id 系の引数に、値をどこから得るかが書かれていません: block_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。
- `API-retrieve-a-data-source`: 35 / 100
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 軽微: 何が返るかが書かれていません。
  - 軽微: 必須の id 系の引数に、値をどこから得るかが書かれていません: data_source_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。
- `API-retrieve-a-database`: 35 / 100
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 軽微: 何が返るかが書かれていません。
  - 軽微: 必須の id 系の引数に、値をどこから得るかが書かれていません: database_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。
- `API-retrieve-a-page-property`: 35 / 100
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 軽微: 制約も例もない文字列の引数: start_cursor
  - 軽微: 引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。
  - 軽微: 何が返るかが書かれていません。
  - 軽微: 必須の id 系の引数に、値をどこから得るかが書かれていません: page_id、property_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。
- `API-retrieve-a-page`: 40 / 100
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 軽微: 何が返るかが書かれていません。
  - 軽微: 必須の id 系の引数に、値をどこから得るかが書かれていません: page_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。
- `API-get-self`: 42 / 100
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 軽微: 何が返るかが書かれていません。
- `API-retrieve-page-markdown`: 50 / 100
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 軽微: 何が返るかが書かれていません。
  - 軽微: 必須の id 系の引数に、値をどこから得るかが書かれていません: page_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。
- `API-update-page-markdown`: 50 / 100
  - 要対応: いつ使うか、いつ使わないかが書かれていません。
  - 要対応: 説明のない引数: replace_content、update_content、insert_content、replace_content_range
  - 軽微: 引数が 3 つ以上あるのに、説明文がどの引数にも触れていません。
  - 軽微: 何が返るかが書かれていません。
  - 軽微: 必須の id 系の引数に、値をどこから得るかが書かれていません: page_id。返してくれるツールや場所を書かないと、モデルは先に探しにいきます。

ご自身のサーバーの掲載をやめてほしい場合は、support@forecall.dev までご連絡ください。7 日以内に外します。

[採点したサーバーの一覧](https://forecall.dev/ja/servers)