Metadata-Version: 2.4
Name: task-mcp
Version: 2.0.1
Summary: MCP Server for Task Management API
Project-URL: Homepage, https://github.com/Aayush9029/mcp-server
Project-URL: Documentation, https://github.com/Aayush9029/mcp-server#readme
Project-URL: Repository, https://github.com/Aayush9029/mcp-server
Project-URL: Issues, https://github.com/Aayush9029/mcp-server/issues
Author-email: Aayush Pokharel <developer@lovedoingthings.com>
License: MIT
License-File: LICENSE
Keywords: api,claude,fastmcp,llm,mcp,task
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: pydantic-settings>=2.0.0
Requires-Dist: pydantic>=2.9.0
Provides-Extra: build
Requires-Dist: pyinstaller>=6.0.0; extra == 'build'
Provides-Extra: dev
Requires-Dist: build>=1.2.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
Requires-Dist: pytest-httpx>=0.32.0; extra == 'dev'
Requires-Dist: pytest>=8.3.0; extra == 'dev'
Requires-Dist: twine>=5.1.0; extra == 'dev'
Description-Content-Type: text/markdown

> [!NOTE]  
> App is in review process, it will be released here
>
>  https://apps.apple.com/app/apple-store/id6746345658
>
> Public Beta avialable here
>
> https://testflight.apple.com/join/E39P1hzw

# MCP Client for iOS

[![Auto Release](https://github.com/Aayush9029/mcp-server/actions/workflows/auto-release.yml/badge.svg)](https://github.com/Aayush9029/mcp-server/actions/workflows/auto-release.yml)
[![pages-build-deployment](https://github.com/Aayush9029/mcp-server/actions/workflows/pages/pages-build-deployment/badge.svg)](https://github.com/Aayush9029/mcp-server/actions/workflows/pages/pages-build-deployment)
[![PyPI version](https://badge.fury.io/py/task-mcp.svg)](https://badge.fury.io/py/task-mcp)
[![Python](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

<p>

![image](https://github.com/user-attachments/assets/a655c5ca-97e9-4ec6-af5b-95b8ebf07d5e)

</p>

### Verified with 
<img src="https://github.com/user-attachments/assets/c05449f1-4da8-4228-9bba-6821f70a3ab8" width="40px" />
<img src="https://github.com/user-attachments/assets/caa206db-bf97-4376-81c1-20d542d5963a" width="40px" />
<img src="https://github.com/user-attachments/assets/c2cbc255-af9b-4683-ba12-c36a4b1e6268" width="40px" />
<img src="https://github.com/user-attachments/assets/ec6c1c3d-8209-406f-986d-4fb1d76b401b" width="40px" />
<img src="https://github.com/user-attachments/assets/220a04be-f6f2-4a3d-b161-b961311d6775" width="40px" />
<img src="https://github.com/user-attachments/assets/69781fbe-5888-4cd0-98d8-be71dbb14e8c" width="40px" />

## Task Management MCP Server

Bridge AI assistants with real-world task management

This MCP server connects Claude Desktop, Cursor, and other AI tools to a powerful task management API, enabling intelligent workflows that create, update, and track tasks automatically on your iPhone.

### What You Can Do

- Ask Claude to create tasks during coding sessions
- Let Cursor update task status as it completes work
- Get notifications on your iPhone when AI assistants finish tasks
- Track progress across multiple AI tools and automation scripts
- Manage priorities with AI-suggested urgency levels

Perfect for developers who want their AI assistants to collaborate on real projects with automatic task tracking and mobile notifications.

## Quick Start

### 1. Get Your API Key

Download the iOS app [here](https://apps.apple.com/app/apple-store/id6746345658)

### 2. Choose Your Setup

#### For Claude Desktop (Recommended)

Add this to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "task-manager": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://task-mcp-server.aayushpokharel9029.workers.dev/sse?apiKey=YOUR_API_KEY"
      ]
    }
  }
}
```

#### For Cursor or Other MCP Clients

```json
{
  "mcpServers": {
    "task-manager": {
      "url": "https://task-mcp-server.aayushpokharel9029.workers.dev/sse?apiKey=YOUR_API_KEY"
    }
  }
}
```

Replace `YOUR_API_KEY` with your actual API key.

### 3. Start Using It

Once configured, your AI assistant can:

- "Create a high-priority task to review the pull request"
- "Show me all pending tasks"
- "Mark the deployment task as completed"
- "Update the bug fix to urgent priority"

## Available Tools

The server provides these capabilities to AI assistants:

### `create_task`
Create new tasks with title, description, priority, and notification settings.

### `list_tasks`
View all tasks with optional filtering by status, priority, or date.

### `get_task`
Get detailed information about any specific task.

### `update_task`
Modify task properties including status, priority, and description.

### `delete_task`
Remove completed or cancelled tasks.

## Technical Details

### Documentation

- **REST API Documentation**:
  - [FastAPI Docs](https://mcpclient.lovedoingthings.com/docs)
  - [ReDoc](https://mcpclient.lovedoingthings.com/redoc#tag/Tasks/operation/create_task_api_tasks__post)
- **MCP Server Documentation**: [https://task-mcp-server.aayushpokharel9029.workers.dev](https://task-mcp-server.aayushpokharel9029.workers.dev)

### API Details

- **Authentication**: API key via `X-API-Key` header
- **Supported Priorities**: LOW, MEDIUM, HIGH, URGENT
- **Supported Statuses**: TODO, IN_PROGRESS, DONE, CANCELLED

## Security & Privacy

- **API Key Isolation**: Each key maintains completely separate task data
- **No Cross-Access**: Tasks are never shared between different API keys
- **Secure Communication**: All requests require authentication headers
- **Real-time Updates**: Changes sync instantly to your iPhone app

## Need Help?

If your AI assistant isn't connecting:

1. Check that your API key is correctly formatted
2. Verify the configuration file location
3. Restart your MCP client after configuration changes

For issues or feature requests, visit the [GitHub Issues](https://github.com/Aayush9029/mcp-server/issues).

---

GitHub: [@Aayush9029](https://github.com/Aayush9029/mcp-server) • Twitter: [@aayushbuilds](https://twitter.com/aayushbuilds)
