mcpField
D
database-query

database-query

github.com/makenotionProductivity3960 installsUpdated 38w ago
Repository

About database-query

database-query is a skill for querying Notion databases through the Notion MCP server. It interprets database names or IDs and requested filters or sorts, then presents a limited, readable summary of matching records.

Key features

  1. 01Find databases by name or ID
  2. 02Apply requested filters and sorts
  3. 03Limit result counts
  4. 04Present key properties in compact tables
  5. 05Summarize rich-text content

Use cases

  1. 01Finding records by status, owner, or due date
  2. 02Reviewing a filtered set of database rows
  3. 03Summarizing matching records for a decision

MCP support

Uses the Notion MCP server to query databases on the user's behalf, applying requested filters and sorts and returning readable results.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/makenotion/cursor-notion-plugin --skill database-query

After installing, type/database-queryin Claude Code to confirm it loaded.

Details

From the project README

Query Notion Database

Use the Notion MCP server to query a database on the user's behalf.

Workflow

  1. Interpret the request to extract:
    • Target database (by name or ID)
    • Optional filter(s) or sort(s) the user describes.
  2. If multiple databases match the name, ask the user to choose the correct one.
  3. Perform a query that:
    • Applies the requested filters (e.g. status = Active, owner = Alice, due date this week).
    • Limits to a reasonable number of rows (e.g. 20-50) unless the user explicitly asks for more.
  4. Present the results in a compact table-like format with:
    • Key properties (e.g. Name, Status, Owner, Due).
    • A short summary if the database has rich text content.
  5. If no rows match, say so clearly and suggest alternative filters.

Important

Avoid dumping raw JSON. Focus on readability and decision-making value for the user.

Comments

Markdown supported