# Support

Thank you for using Time Doctor MCP! This document provides information on how to get help and support.

## Getting Help

### Documentation

Before reaching out for support, please check the following resources:

- **[README.md](README.md)** - Installation, setup, and usage instructions
- **[CONTRIBUTING.md](CONTRIBUTING.md)** - Development setup and contribution guidelines
- **[GitHub Issues](https://github.com/frifster/timedoctor-mcp/issues)** - Known issues and bug reports

### Common Issues

**MCP Server Won't Start:**
- Check `timedoctor_mcp.log` in the project directory
- Verify credentials in `.env` file
- Ensure Python path is absolute in MCP config

**Login Fails:**
- Verify credentials are correct
- Check if Time Doctor requires 2FA (not supported)
- Review logs for error messages

**No Data Returned:**
- Verify you have time tracking data for those dates
- Check log file for parsing errors
- Test with today's date first

For more troubleshooting tips, see the [Troubleshooting section](README.md#troubleshooting) in the README.

## Reporting Issues

If you encounter a bug or have a feature request:

1. **Search existing issues** - Check if someone has already reported it
2. **Create a new issue** - Go to [GitHub Issues](https://github.com/frifster/timedoctor-mcp/issues/new)
3. **Provide details** - Include:
   - Clear description of the issue
   - Steps to reproduce
   - Expected vs actual behavior
   - Environment (OS, Python version, MCP client)
   - Relevant logs from `timedoctor_mcp.log`

## Contact

For questions, support requests, or feedback that don't fit into GitHub Issues:

**Email:** [frifster2014@gmail.com](mailto:frifster2014@gmail.com)

Please include the following in your email:
- A clear subject line (e.g., "Time Doctor MCP: Login Issue")
- Detailed description of your question or issue
- Steps you've already tried
- Relevant log excerpts (if applicable)

**Note:** Response times may vary. For faster responses on common issues, please use GitHub Issues where the community can help.

## Security Issues

If you discover a security vulnerability, please **DO NOT** open a public issue. Instead, email me directly at:

**Security Contact:** [frifster2014@gmail.com](mailto:frifster2014@gmail.com)

Include:
- Description of the vulnerability
- Steps to reproduce
- Potential impact
- Suggested fix (if any)

I will respond as quickly as possible and work with you to address the issue.

## Support the Project

If Time Doctor MCP has been helpful to you, consider supporting the project:

[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-Support-yellow?style=for-the-badge&logo=buy-me-a-coffee)](https://buymeacoffee.com/frifster)

Your support helps maintain and improve this project. Thank you! ☕

## Community

- **GitHub Repository:** [frifster/timedoctor-mcp](https://github.com/frifster/timedoctor-mcp)
- **Issues:** [Report bugs or request features](https://github.com/frifster/timedoctor-mcp/issues)

---

**Maintainer:** frifster
**Contact:** frifster2014@gmail.com
**License:** MIT
