# Goaly MCP
A goal and task management system with Model Context Protocol (MCP) integration and a real-time dashboard.
## Features
- **Goal & Task Management**: Create goals with tasks stored in a DAG
- **MCP Integration**: FastMCP 2.0 server for AI agent interaction
- **Real-time Dashboard**: React-based dashboard with live updates via SSE
- **Task Dependencies**: Manage complex task relationships and blocking dependencies
- **RESTful API**: Complete FastAPI-based REST API
- **Database Migrations**: Alembic-powered database versioning
- **Production Ready**: Docker support, monitoring, and deployment tools
## Quick Start
### Prerequisites
- Python 3.12+
- Node.js 18+
- pnpm (for frontend)
### Installation
```bash
# Complete setup
just setup
# Start development
just serve
# View dashboard
open http://localhost:8000/dashboard
```
### API Documentation
- **Dashboard**: http://localhost:8000/dashboard
- **API Docs**: http://localhost:8000/docs
- **MCP Server**: http://localhost:8000/mcp
## Development
```bash
# Install dependencies
just install
# Run tests
just test
# Format & lint
just fmt && just lint
# Build for production
just build-all
```
## Architecture
- **Backend**: FastAPI + SQLAlchemy + Alembic
- **Frontend**: React + Material-UI + D3.js
- **Database**: PostgreSQL (production) / SQLite (development)
- **MCP Server**: FastMCP 2.0 for AI agent integration
- **Real-time**: Server-Sent Events (SSE)
## 🤝 Contributing
Found a bug? Have an idea? We'd love your help!
- 🐛 [Report issues](https://github.com/toolprint/goaly-mcp/issues)
- 💡 [Share ideas](https://github.com/toolprint/goaly-mcp/discussions)
- 🔧 [Submit PRs](https://github.com/toolprint/goaly-mcp/pulls)
## 📄 License
MIT License - see [LICENSE](LICENSE) file for details.
______________________________________________________________________
<div align="center">
**Built by developers who got tired of watching AI pick the wrong tools** 🎯
<a href="https://toolprint.ai">
<img src="./assets/toolprint.png" alt="Toolprint" width="200">
</a>
<p>
<strong>Built with ❤️ by <a href="https://toolprint.ai">Toolprint</a></strong><br>
<sub>© 2025 OneGrep, Inc.</sub>
</p>
</div>
Raw data
{
"_id": null,
"home_page": null,
"name": "goaly-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "agent, ai, claude, fastmcp, goals, goaly, llm, mcp, model-context-protocol, task-management, toolprint",
"author": null,
"author_email": "Brian Cripe <brian@onegrep.dev>",
"download_url": "https://files.pythonhosted.org/packages/62/4e/d187799731745225e5cd9e1710e7e373d95a4efc3a2a57fa3eadda6de131/goaly_mcp-0.0.0.tar.gz",
"platform": null,
"description": "# Goaly MCP\n\nA goal and task management system with Model Context Protocol (MCP) integration and a real-time dashboard.\n\n## Features\n\n- **Goal & Task Management**: Create goals with tasks stored in a DAG\n- **MCP Integration**: FastMCP 2.0 server for AI agent interaction\n- **Real-time Dashboard**: React-based dashboard with live updates via SSE\n- **Task Dependencies**: Manage complex task relationships and blocking dependencies\n- **RESTful API**: Complete FastAPI-based REST API\n- **Database Migrations**: Alembic-powered database versioning\n- **Production Ready**: Docker support, monitoring, and deployment tools\n\n## Quick Start\n\n### Prerequisites\n\n- Python 3.12+\n- Node.js 18+\n- pnpm (for frontend)\n\n### Installation\n\n```bash\n# Complete setup\njust setup\n\n# Start development\njust serve\n\n# View dashboard\nopen http://localhost:8000/dashboard\n```\n\n### API Documentation\n\n- **Dashboard**: http://localhost:8000/dashboard\n- **API Docs**: http://localhost:8000/docs\n- **MCP Server**: http://localhost:8000/mcp\n\n## Development\n\n```bash\n# Install dependencies\njust install\n\n# Run tests\njust test\n\n# Format & lint\njust fmt && just lint\n\n# Build for production\njust build-all\n```\n\n## Architecture\n\n- **Backend**: FastAPI + SQLAlchemy + Alembic\n- **Frontend**: React + Material-UI + D3.js\n- **Database**: PostgreSQL (production) / SQLite (development)\n- **MCP Server**: FastMCP 2.0 for AI agent integration\n- **Real-time**: Server-Sent Events (SSE)\n\n## \ud83e\udd1d Contributing\n\nFound a bug? Have an idea? We'd love your help!\n\n- \ud83d\udc1b [Report issues](https://github.com/toolprint/goaly-mcp/issues)\n- \ud83d\udca1 [Share ideas](https://github.com/toolprint/goaly-mcp/discussions)\n- \ud83d\udd27 [Submit PRs](https://github.com/toolprint/goaly-mcp/pulls)\n\n## \ud83d\udcc4 License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n______________________________________________________________________\n\n<div align=\"center\">\n\n**Built by developers who got tired of watching AI pick the wrong tools** \ud83c\udfaf\n\n<a href=\"https://toolprint.ai\">\n <img src=\"./assets/toolprint.png\" alt=\"Toolprint\" width=\"200\">\n</a>\n\n<p>\n <strong>Built with \u2764\ufe0f by <a href=\"https://toolprint.ai\">Toolprint</a></strong><br>\n <sub>\u00a9 2025 OneGrep, Inc.</sub>\n</p>\n\n</div>\n",
"bugtrack_url": null,
"license": null,
"summary": "Goaly MCP - Goal and Task Management with Model Context Protocol",
"version": "0.0.0",
"project_urls": {
"Documentation": "https://toolprint.github.io/goaly-mcp/",
"Homepage": "https://toolprint.ai",
"Issues": "https://github.com/toolprint/goaly-mcp/issues",
"Repository": "https://github.com/toolprint/goaly-mcp.git"
},
"split_keywords": [
"agent",
" ai",
" claude",
" fastmcp",
" goals",
" goaly",
" llm",
" mcp",
" model-context-protocol",
" task-management",
" toolprint"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "3b36f826b4d4f0e3eb1e0113eb19505c860135003ac540196352c71ef1bd360b",
"md5": "281adb30f4e97f1f76b0dd3e47cc2776",
"sha256": "d0408db219c2887fdc875fb282daeeb5124f25c67a75b00c1419a4da59612a18"
},
"downloads": -1,
"filename": "goaly_mcp-0.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "281adb30f4e97f1f76b0dd3e47cc2776",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 69511,
"upload_time": "2025-08-25T22:03:04",
"upload_time_iso_8601": "2025-08-25T22:03:04.050838Z",
"url": "https://files.pythonhosted.org/packages/3b/36/f826b4d4f0e3eb1e0113eb19505c860135003ac540196352c71ef1bd360b/goaly_mcp-0.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "624ed187799731745225e5cd9e1710e7e373d95a4efc3a2a57fa3eadda6de131",
"md5": "5c00ba218f3ba6fa3d6c2bbc10deff3a",
"sha256": "fc722fed64b4b0e48400ac695d1b08235119e64c9c1ddf92a871680099a4728b"
},
"downloads": -1,
"filename": "goaly_mcp-0.0.0.tar.gz",
"has_sig": false,
"md5_digest": "5c00ba218f3ba6fa3d6c2bbc10deff3a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 556964,
"upload_time": "2025-08-25T22:03:05",
"upload_time_iso_8601": "2025-08-25T22:03:05.682203Z",
"url": "https://files.pythonhosted.org/packages/62/4e/d187799731745225e5cd9e1710e7e373d95a4efc3a2a57fa3eadda6de131/goaly_mcp-0.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-25 22:03:05",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "toolprint",
"github_project": "goaly-mcp",
"github_not_found": true,
"lcname": "goaly-mcp"
}