nlook-mcp

NLook MCP (Model Context Protocol) Server for Claude Desktop and other AI tools.

Overview

This MCP server enables AI assistants like Claude to directly interact with your NLook account, allowing you to:

• Save AI-generated content as documents
• Manage your task/todo list
• Search and retrieve existing documents
• Update and delete content

Installation

npm install -g nlook-mcp

Or use with npx (recommended):

npx nlook-mcp

Setup

1. Get Your API Key

1. Go to NLook Profile
2. Find API Key section
3. Copy your API key
4. If you don't have one, click Generate API Key

Note: Your API key provides full access to your NLook account. Keep it secure and never share it publicly.

2. Configure Claude Desktop

Edit your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the NLook server:

{
  "mcpServers": {
    "nlook": {
      "command": "npx",
      "args": ["-y", "nlook-mcp"],
      "env": {
        "NLOOK_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Restart Claude Desktop

After saving the configuration, restart Claude Desktop to load the NLook MCP server.

Available Tools

📄 Documents

| Tool | Description | |------|-------------| | create_document | Save a new document to NLook. Supports HTML format with auto file upload. | | list_documents | Get a list of documents with optional search/filter by tags | | get_document | Get full content of a specific document including appended entries | | update_document | Update an existing document's title, content, or tags | | delete_document | Delete a document permanently | | append_to_document | Append content to an existing document (AI sessions, notes, summaries) | | list_document_entries | Get all entries appended to a document | | delete_document_entry | Delete a specific entry from a document |

✅ Tasks

| Tool | Description | |------|-------------| | create_task | Create a new task/todo with priority, due date, and notes | | list_tasks | Get tasks filtered by status, priority, or task list | | update_task | Update task details, status, or priority | | delete_task | Delete a task | | complete_task | Mark a task as completed with optional completion report | | append_to_task | Append content to a task (AI sessions, progress notes, summaries) | | list_task_entries | Get all entries appended to a task | | delete_task_entry | Delete a specific entry from a task |

📁 Task Lists

| Tool | Description | |------|-------------| | list_task_lists | Get all task lists | | create_task_list | Create a new task list with custom color |

☁️ Google Drive

| Tool | Description | |------|-------------| | upload_to_google_drive | Upload a local file to your connected Google Drive |

Note: Google Drive integration requires connecting your Google Drive account in NLook Profile first.

📊 Statistics & Reports

| Tool | Description | |------|-------------| | get_weekly_report | Get weekly productivity report with daily activity, timeline, and insights | | get_current_week_report | Get productivity report for the current week (Monday to Sunday) | | get_task_stats | Get task statistics: completion rates, priority breakdown, overdue analysis | | get_document_stats | Get document statistics: total count, tag usage, writing streak | | get_activity_stats | Get activity patterns: most productive days/hours, trends | | get_productivity_summary | Get comprehensive productivity summary with actionable insights |

🔧 Admin Tools (Admin Only)

| Tool | Description | |------|-------------| | admin_get_summary | Get admin dashboard summary (users, documents, tasks counts) | | admin_list_blogs | List all blog posts including inactive ones | | admin_create_blog | Create a new blog post (supports Korean/English) | | admin_update_blog | Update an existing blog post | | admin_list_releases | List all release notes including unpublished | | admin_create_release | Create a new release note | | admin_update_release | Update an existing release note |

Usage Examples

Saving Content

Save this meeting notes to NLook:

# Team Meeting - December 2024

## Attendees
- Alice
- Bob

## Discussion
- Project timeline review
- Resource allocation

## Action Items
1. Alice: Update documentation
2. Bob: Review pull requests

Managing Tasks

Add a task to NLook:
- Title: Review quarterly report
- Priority: high
- Due: tomorrow

Show me my pending tasks in NLook

Mark task #123 as completed in NLook

Uploading Files to Google Drive

Upload this image to Google Drive:
/Users/username/Downloads/screenshot.png

Save this file to my Google Drive: /path/to/document.pdf

Searching Documents

Find all documents tagged with "meeting" in NLook

Get the document with ID 456 from NLook

Appending to Documents

Append today's meeting notes to document #123 in NLook

Add this summary as an AI session entry to document #456

Appending to Tasks

Append this AI response to task #123 in NLook as an ai_session entry

Add a progress update to task #456: "Completed 50% of the implementation"

Show all entries appended to task #789 in NLook

Productivity Reports

Show me my productivity report for this week in NLook

Get my task completion statistics from NLook

Show my document activity stats for the last 30 days

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | NLOOK_API_KEY | Yes | Your NLook API key | | NLOOK_API_URL | No | Custom API URL (default: https://nlook.me) |

Google Drive Prerequisites

To use the Google Drive upload feature:

1. Go to NLook Profile
2. Find Google Drive in the integrations section
3. Click Connect and authorize NLook to access your Google Drive
4. Once connected, you can upload files through the MCP server

Uploaded files will be stored in a folder named nlook in your Google Drive.

Troubleshooting

"Invalid API key" error

• Verify your API key is correct
• Go to NLook Profile to check your API key
• Generate a new key if needed

"Permission denied" error

• Your API key provides full access, so this is likely a server issue
• Try regenerating your API key in NLook Profile

Server not appearing in Claude

• Ensure configuration file is valid JSON
• Check the path to the configuration file is correct
• Restart Claude Desktop after changes

"Google Drive integration required" error

• Connect your Google Drive in NLook Profile
• Ensure the connection is still active (re-authorize if needed)

"Google Drive reconnection required" error

• Your Google Drive authorization has expired
• Go to NLook Profile and reconnect Google Drive

활용 가이드 (Advanced Usage)

Claude Code 자동 개발일지 연동

NLook MCP를 활용하여 Claude Code에서 개발 완료 시 자동으로 개발일지를 저장할 수 있습니다.

1. Claude Code MCP 설정

~/.claude.json 파일에 NLook MCP 서버를 추가합니다:

{
  "mcpServers": {
    "nlook": {
      "command": "npx",
      "args": ["-y", "nlook-mcp"],
      "env": {
        "NLOOK_API_KEY": "your-api-key-here"
      }
    }
  }
}

2. 글로벌 자동 문서화 설정

~/.claude/CLAUDE.md 파일을 생성하고 아래 내용을 추가합니다:

# 개발 완료 시 자동 문서화 (NLook 연동)

## 자동 문서 저장 방식 (프로젝트별 + 날짜별 Append)
작업 완료 시 **프로젝트별 날짜 단일 문서**에 내용을 추가(append)합니다.

### 저장 흐름
1. 현재 프로젝트명 확인 (git remote 또는 폴더명)
2. mcp__nlook__list_documents로 오늘 날짜 문서 검색
   - search: "[{프로젝트명} 개발일지] YYYY-MM-DD"
3-A. 문서가 있으면 → mcp__nlook__update_document로 append
3-B. 문서가 없으면 → mcp__nlook__create_document로 새로 생성

### 문서 제목 형식
[{프로젝트명} 개발일지] YYYY-MM-DD

### 문서 구조 (Markdown)
## ⏰ HH:MM - {이모지} {작업 제목}

### 📋 변경 내용
- 변경사항 목록

### 📁 수정 파일
- `파일경로` - 설명

### 💻 주요 코드
\`\`\`language
// 핵심 코드 스니펫
\`\`\`

### 작업 유형 이모지
- ✨ 신규 기능
- 🔧 버그 수정
- 🎨 UI/UX 개선
- ♻️ 리팩토링
- 📝 문서화
- 🌐 i18n 다국어

### 태그
["개발일지", "{프로젝트명}", "YYYY-MM"]

3. 수동 저장 커맨드 (선택사항)

~/.claude/commands/save-dev-log.md 파일을 생성하여 /save-dev-log 명령어로 수동 저장할 수 있습니다:

# 개발 완료 문서 수동 저장

현재 세션에서 완료한 개발 작업을 NLook 개발일지에 저장합니다.

## 실행 순서
1. git diff --stat로 변경 파일 확인
2. 프로젝트명 확인 (git remote 또는 폴더명)
3. 오늘 날짜 개발일지 문서 검색
4. 새 작업 내용 Markdown 생성
5. 문서 업데이트 또는 생성
6. 저장된 문서 URL 사용자에게 공유

저장 결과 예시

개발 완료 시 아래와 같은 형식으로 NLook에 자동 저장됩니다:

# 📅 MyProject 개발일지

**날짜:** 2024년 12월 4일 (수)

---

## ⏰ 14:30 - ✨ 사용자 인증 기능 추가

### 📋 변경 내용
- OAuth2 Google 로그인 구현
- JWT 토큰 관리 로직 추가
- 로그인 페이지 UI 구현

### 📁 수정 파일
- `src/auth/oauth.ts` - Google OAuth 클라이언트 설정
- `src/auth/jwt.ts` - JWT 토큰 생성/검증
- `src/pages/LoginPage.tsx` - 로그인 UI 컴포넌트

### 💻 주요 코드

\`\`\`typescript
export const generateJWT = (userId: string): string => {
  return jwt.sign({ userId }, SECRET_KEY, { expiresIn: '7d' });
};
\`\`\`

 

---

 

## ⏰ 16:45 - 🔧 세션 만료 버그 수정

### 📋 변경 내용
- 토큰 갱신 로직 개선
- 만료 시 자동 로그아웃 처리

### 📁 수정 파일
- `src/auth/session.ts` - 세션 관리 로직 수정

License

MIT

Support

• NLook Website
• Email: [email protected]
• GitHub Issues