Skip to content

Commit 10beebd

Browse files
committed
updated the docs for notion mcp server
1 parent 82983df commit 10beebd

1 file changed

Lines changed: 82 additions & 0 deletions

File tree

docs/mcp_notion_brain.md

Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
# MCP Server to Brain Dump to Notion
2+
3+
Brain Dumping the ideas and tasks into Notion
4+
database and later managing them with due dates,
5+
areas and resources is a classic system. This MCP
6+
client just needs you to type out your tasks on a
7+
terminal. The server will then move it to the
8+
database.
9+
10+
MCP servers have the tools, and resources that can
11+
be made to work with notion database and its
12+
properties.
13+
14+
We are implementing the MCP Server to connect with
15+
Notion database through the notion integration
16+
API. We are building this so the brain dump
17+
process can be directly done from any terminal
18+
that support python.
19+
20+
## Project Details:
21+
22+
- Project Path: ../notion_brain_dump/
23+
24+
### Project setup commands:
25+
26+
```bash
27+
cd notion_brain_dump
28+
uv run mcpclient.py server.py
29+
30+
After the client start, you will be prompted for the query.
31+
32+
Query: Provide me the list of the tasks available.
33+
```
34+
35+
### Available MCP Server Tools:
36+
37+
- Add Task
38+
- List Tasks
39+
- Update Tasks
40+
- Remove Tasks
41+
- Add Area
42+
- Add Resource
43+
44+
These tool are using mcp resources that are
45+
connecting with the notion db.
46+
47+
When you need use mcp inspector to debug the code,
48+
use the command below. Ensure you have
49+
[npx](https://docs.npmjs.com/cli/v8/commands/npx)
50+
and [node](https://nodejs.org/en/download)
51+
installed
52+
53+
npx @modelcontextprotocol/inspector uv run
54+
server.py
55+
56+
### Project Description:
57+
58+
The server.py contains the tools to connect with
59+
notion database through its API integration. The
60+
mcpclient.py contains the code to connect with
61+
LLMs and user.
62+
63+
The functions used in the server.py is taken from
64+
the ../fw_ex/praw_spiked/vabired_app02.py. The MCP
65+
server and client are a different interface to the
66+
way we interact with the computers. So instead of
67+
using REST API servers, we will use plain english.
68+
69+
### Project References
70+
71+
- Server code referred from :
72+
[MCP Installation](https://github.com/modelcontextprotocol/python-sdk?tab=readme-ov-file#installation)
73+
74+
- Client code referred from:
75+
[Introducing Clients](https://modelcontextprotocol.io/quickstart/client)
76+
77+
- Notion Code referred from:
78+
[Notion Example code](../fw_ex/notionapi_spike/)
79+
80+
```
81+
82+
```

0 commit comments

Comments
 (0)