|
|
--- |
|
|
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 ☕️ |
|
|
|
