Thank you for your interest in contributing! NotionMind is a free, open-source project and welcomes contributions of all kinds.
- Check existing issues first
- Open a new issue with:
- What you did
- What you expected
- What actually happened
- Your OS and Python version
Open an issue with the enhancement label. Describe:
- The problem it solves
- How you'd want it to work
- Any real-world use case
git clone https://github.com/Jeffrin-dev/NotionMind.git
cd NotionMind
python3 -m venv venv
source venv/bin/activate
pip install notion-client==2.2.1 groq python-dotenv rich \
httpx mcp httpx-sse ddgs SpeechRecognition \
pyaudio edge-tts pygame
cp .env.example .env
# fill in your API keys- Fork the repo
- Create a branch:
git checkout -b feature/your-feature-name - Make your changes
- Test manually with
python3 notionmind.py - Commit:
git commit -m "feat: describe your change" - Push:
git push origin feature/your-feature-name - Open a Pull Request
feat: add new feature
fix: fix a bug
docs: update documentation
refactor: restructure code without changing behavior
| File | Purpose |
|---|---|
notionmind.py |
Main CLI interface |
agent.py |
MCP-powered natural language agent |
executor.py |
Autonomous task executor |
mcp_client.py |
Notion MCP tools and dispatcher |
search.py |
DuckDuckGo web search |
voice.py |
Voice input/output |
- Add support for more voice languages
- Add a
--quietflag to suppress voice output - Add note export to markdown file
- Add support for Notion databases with custom column names
- Add a
todaycommand that shows only today's notes
By contributing, you agree your contributions will be licensed under the MIT License.