Hugging Face's logo

Spaces:
Agents-MCP-Hackathon
/
NotionTaskSense
Sleeping

App Files Community
2
NotionTaskSense / README.md
srikanthpusthem's picture
srikanthpusthem
Update README.md
a5d45f9 verified
preview code
|
raw
history blame
2.92 kB
metadata
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:

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

👥 Contributors

Built with care, caffeine, and curiosity ☕️