database-query — Claude Code skill for Notion database lookups
This skill finds a Notion database by name or ID and returns matching rows as a compact table, applying filters and sorting you describe in plain words.
npx skills add makenotion/cursor-notion-plugin --skill database-query -a claude-codeWhat database-query does
It runs the lookup through the Notion MCP server. First it works out which database you mean and what filters and sorts to apply. If several databases share the name, the agent asks you to pick one.
Row count stays sensible unless you ask for more. What comes back is a table with the key properties plus a short summary of any long text fields. Raw JSON is kept out of the answer on purpose, since a table is easier to read and act on.
An empty result gets called out, along with a suggestion for different filters. You need the Notion MCP server connected — the query has nowhere to run without it.
What it helps with
- pull every Active task from a Notion database
- list one owner's rows for the current week
- locate a database when you only know its name
- get a readable table instead of raw JSON
- adjust filters after an empty result
Example prompts for the agent
- Query the Notion database Tasks for rows where Status is Active, show Name, Status, Owner, Due
- Find the Notion database called Roadmap and list upcoming items sorted by date
- Pull up to 30 rows from the clients database where Owner is Alice
How to install database-query
1Skills CLI (Vercel)
npx skills add makenotion/cursor-notion-plugin --skill database-query -a claude-code2Manually: put the files in place
~/.claude/skills/database-query/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/database-query/
1Skills CLI (Vercel)
npx skills add makenotion/cursor-notion-plugin --skill database-query -a codex2Manually: put the files in place
.agents/skills/database-query/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add makenotion/cursor-notion-plugin --skill database-query -a cursor2Manually: put the files in place
.cursor/skills/database-query/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install makenotion/cursor-notion-plugin database-query2Manually: put the files in place
.github/skills/database-query/SKILL.md1Skills CLI (Vercel)
npx skills add makenotion/cursor-notion-plugin --skill database-query -a gemini-cli2Platform CLI
gemini skills install https://github.com/makenotion/cursor-notion-plugin --path skills/database-queryManually: put the files in place
.devin/skills/database-query/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add makenotion/cursor-notion-plugin --skill database-query -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about database-query
How do I install database-query in Claude Code?
Run npx skills add makenotion/cursor-notion-plugin --skill database-query -a claude-code; the skill lands in ~/.claude/skills/database-query/SKILL.md.
What does database-query do?
It locates a Notion database by name or ID, applies the filters and sorting from your request, and returns the rows in a table with key properties.
What does it need to work?
A connected Notion MCP server — every query goes through it.
