File size: 2,923 Bytes
4162173
2157da9
 
4162173
 
 
 
 
 
 
 
de5b666
 
efe51c1
de5b666
efe51c1
de5b666
efe51c1
 
 
 
 
de5b666
efe51c1
de5b666
efe51c1
 
 
 
de5b666
efe51c1
de5b666
efe51c1
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
de5b666
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
46afd6d
de5b666
 
 
46afd6d
 
 
de5b666
 
 
2fc28ea
de5b666
2157da9
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
---
title: NotionTaskSense
emoji: 🧠
colorFrom: pink
colorTo: green
sdk: gradio
sdk_version: 5.33.0
app_file: app.py
pinned: false
---

# 🧠 NotionTaskSense

NotionTaskSense is an AI-powered tool that helps you organize your goals into structured tasks in Notion. It uses natural language processing to break down your goals into actionable tasks and automatically creates them in your Notion workspace.

## Features

- πŸ€– AI-powered task breakdown
- πŸ“ Automatic Notion task creation
- 🎯 Smart task organization
- πŸ”„ Real-time processing
- 🌐 API access available

## How to Use

1. Enter your goals or tasks in natural language
2. The AI will analyze and break them down into structured tasks
3. Tasks are automatically created in your Notion workspace
4. Access your organized tasks in Notion

## API Usage

You can also use NotionTaskSense via its API endpoint:

```bash
curl -X POST http://your-space-url/api/predict \
  -H "Content-Type: application/json" \
  -d '{"data": ["Your task description here"], "fn_index": 0}'
```

## Environment Variables Required

- `ANTHROPIC_API_KEY`: Your Anthropic API key for Claude
- `NOTION_API_KEY`: Your Notion integration token
- `NOTION_DATABASE_ID`: (Optional) Default Notion database ID

## Local Development

1. Clone the repository
2. Install dependencies: `pip install -r requirements.txt`
3. Set up environment variables
4. Run the app: `python app.py`

## Deployment

This app is deployed on Hugging Face Spaces and can be accessed at [space-url].

## License

MIT License

---

## πŸ”§ Powered By

- πŸ’¬ Claude 3 API (Anthropic) for intelligent task parsing  
- πŸ“‹ Notion API for task organization  
- 🧠 Gradio (MCP Tool) interface  
- πŸ€— Hosted on Hugging Face Spaces  

---

## πŸ› οΈ How to Use

1. Enter your fuzzy goal or weekly plan into the textbox  
2. Click "Organize into Notion"  
3. Watch tasks appear in your connected Notion database

---

## 🧠 Tech Highlights

- MCP-compatible @tool with `organize_goals_into_notion(user_input)`
- Real-time Claude-powered JSON parsing
- Automatic Notion DB creation & population

---

## πŸ”’ Secrets Required (in Hugging Face Settings)

| Key                   | Description                       |
|------------------------|-----------------------------------|
| ANTHROPIC_API_KEY      | Claude API key (e.g. Claude 3 Haiku)  
| NOTION_TOKEN           | Your Notion Integration Token  
| NOTION_PARENT_PAGE_ID | The ID of the Notion page to create the task database under  

---

## πŸ“Œ Hackathon Submission

Built for the **Gradio Agents + MCP Hackathon (2025)**  
Track: `mcp-server-track`  


---

## YouTube video Link:
-[Youtube Link](https://www.youtube.com/watch?v=wGOMneDNPQo)

## πŸ‘₯ Contributors

- [Srinikhil Durisetti](https://huggingface.co/srinikhildurisetti)  
- [Srikanth Pusthem](https://huggingface.com/srikanthpusthem)

Built with care, caffeine, and curiosity β˜•οΈ