nlook-mcp-server

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-server

Or use with npx (recommended):

npx nlook-mcp-server

Setup

1. Get Your API Key

1. Go to NLook Settings
2. Navigate to API Key Management
3. Click Create New API Key
4. Set permissions (read, write, delete)
5. Copy and save the API key (shown only once!)

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-server"],
      "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 | | list_documents | Get a list of documents with optional search/filter | | get_document | Get full content of a specific document | | update_document | Update an existing document | | delete_document | Delete a document |

Tasks

| Tool | Description | |------|-------------| | create_task | Create a new task/todo | | list_tasks | Get a list of tasks with optional filters | | update_task | Update task details or status | | delete_task | Delete a task | | complete_task | Mark a task as completed |

Task Lists

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

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

Searching Documents

Find all documents tagged with "meeting" in NLook

Get the document with ID 456 from NLook

Environment Variables

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

Troubleshooting

"Invalid API key" error

• Verify your API key is correct
• Check the key is still active in NLook settings
• Ensure the key hasn't expired

"Permission denied" error

• Check your API key has the required permissions (read/write/delete)
• Create a new key with appropriate permissions if needed

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

Development

# Clone the repository
git clone https://github.com/nlook-service/nlook.git
cd nlook/packages/mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run locally
NLOOK_API_KEY=your-key npm start

License

MIT

Support

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