# mcp-todo MCP Server

mcp-todo 앱의 Todo/Memo API를 MCP (Model Context Protocol)로 연결하는 서버입니다.

## 설치

```bash
npm install -g mcp-todo-app-server
```

## 환경 변수

| 변수 | 필수 | 설명 |
|------|------|------|
| `MCP_TODO_WORKSPACE_ID` | **필수** | mcp-todo 앱에서 발급받은 Workspace ID |
| `MCP_TODO_API_URL` | 선택 | API URL (기본값 설정됨) |

## Claude Desktop 앱에서 사용하기

`~/Library/Application Support/Claude/claude_desktop_config.json` 파일을 열고 (없으면 생성):

```json
{
  "mcpServers": {
    "mcp-todo": {
      "command": "npx",
      "args": ["-y", "mcp-todo-app-server"],
      "env": {
        "MCP_TODO_WORKSPACE_ID": "여기에-워크스페이스-ID-입력"
      }
    }
  }
}
```

설정 후 Claude Desktop 앱을 재시작하세요.

## Claude Code (CLI)에서 사용하기

`~/.claude/settings.json` 파일에 추가:

```json
{
  "mcpServers": {
    "mcp-todo": {
      "command": "npx",
      "args": ["-y", "mcp-todo-app-server"],
      "env": {
        "MCP_TODO_WORKSPACE_ID": "여기에-워크스페이스-ID-입력"
      }
    }
  }
}
```

## 사용 가능한 Tools

### Todo 관련

| Tool | 설명 |
|------|------|
| `list_todos` | 일정 목록 조회 (카테고리, 날짜 필터 가능) |
| `create_todo` | 새 일정 생성 |
| `update_todo` | 일정 수정 |
| `delete_todo` | 일정 삭제 |

### Memo 관련

| Tool | 설명 |
|------|------|
| `list_memos` | 메모 목록 조회 |
| `get_memo` | 메모 상세 조회 |
| `create_memo` | 새 메모 생성 |
| `update_memo` | 메모 수정 |
| `delete_memo` | 메모 삭제 |

## 사용 예시

Claude에게 다음과 같이 요청할 수 있습니다:

- "오늘 할 일 목록 보여줘"
- "내일 14시에 '팀 미팅' 일정 추가해줘"
- "'회의록' 제목으로 새 메모 만들어줘"
- "일정 완료 처리해줘"

## License

MIT