notion_searchLABSCO SUMMARY
An agent can work inside your Notion rather than describe what to paste there.
Find the page by searching instead of remembering where it lives, read what is on it block by block, and append or update in place. What it can reach is exactly what you shared with the integration — no more.
What it is
A Notion workspace client. It searches, reads pages and their block children, creates pages and databases, updates page properties, and queries a database with filters. Authorization runs through Nango, with a direct Notion token as the alternative.
What you get
- Search across the pages and databases the integration can see
- A page fetched, and its block children read back
- New pages created, and existing pages updated
- New databases created, a database's schema read, and its rows queried with filters
- Blocks appended to an existing page
- The identity the integration is acting as
Requirements
Python 3.8 or newer, and a Notion integration with read, insert and update capability. Every page or database you want reachable has to be shared with that integration first — that is the step people miss. Authorization is configured through Nango; a direct Notion token also works.
Setup effort
One command plus a key — uvx git+https://github.com/Shameerpc5029/notion-mcp.git, then supply credentials
USE CASES
01
Finding the page you half remember
Search on a phrase from it and open the result, rather than clicking down a tree of sub-pages.
02
Reading a doc properly before acting on it
Fetch the page and walk its block children, so the model works from the whole content rather than the title and a preview.
03
Writing meeting notes where they belong
Find the parent, create the page under it, and append the notes as blocks while the meeting is still fresh.
04
Pulling the rows that match a condition
Read the database schema so the property names are right, then query it with the filter you actually want.
05
Updating a status without opening the board
Query for the row, then update its properties in place.
06
Standing up a new tracker
Create the database with its properties and seed the first pages into it in one pass.
10 tools
Listed in project docs. Your client may show a different list.
notion_get_databasenotion_query_databasenotion_create_databasenotion_get_pagenotion_create_pagenotion_update_pagenotion_get_block_childrennotion_append_blocksnotion_get_current_userBEFORE YOU INSTALL
What to know first
Tools you get
10 tools named in the project's documentation.
Requires
- uvx on PATH
- Python 3.8 or later
- NANGO_SECRET_KEY in your environment
- NANGO_CONNECTION_ID in your environment
Optional
NOTION_TOKEN in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
uvx git+https://github.com/Shameerpc5029/notion-mcp.gitMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"notion": {
"command": "uvx",
"args": [
"git+https://github.com/Shameerpc5029/notion-mcp.git"
],
"env": {
"NANGO_BASE_URL": "https://api.nango.dev",
"NANGO_SECRET_KEY": "<YOUR_NANGO_SECRET_KEY>",
"NANGO_CONNECTION_ID": "<YOUR_NANGO_CONNECTION_ID>",
"NANGO_INTEGRATION_ID": "notion"
}
}
}
}The configuration on this page does not set NOTION_TOKEN; the project's instructions put it in a .env file. To supply NOTION_TOKEN without depending on where the server looks for that file, use the block's "env" section.
