Skip to main content
Glama
Sign In
notlai-mcp

notlai-mcp

by lzientek
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

Notlai MCP

Access your Notlai notes directly from any MCP-compatible AI assistant. Create, search, organize, and read your notes with Markdown support — all through natural conversation.

Quick Start

1. Create an account

Go to www.notlai.com/signup and sign up with your email address. You'll receive a verification code by email — enter it to activate your account.

2. Install the MCP server

Choose the method matching your AI assistant:

Claude Desktop (Extension)

Download the .mcpb file from the latest release, then double-click it. Claude Desktop will install the extension automatically.

Claude Desktop (Manual)

Add to your config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "notlai": {
      "command": "npx",
      "args": ["-y", "notlai-mcp"]
    }
  }
}

Restart Claude Desktop.

Kiro

Add to .kiro/settings/mcp.json in your workspace (or ~/.kiro/settings/mcp.json for global access):

{
  "mcpServers": {
    "notlai": {
      "command": "npx",
      "args": ["-y", "notlai-mcp"],
      "timeout": 30000,
      "type": "stdio",
      "autoApprove": [
        "notlai_status",
        "notlai_list_notes",
        "notlai_get_note",
        "notlai_list_tags"
      ]
    }
  }
}

Note: The timeout and autoApprove fields are recommended for Kiro. Without timeout, the first launch (when npx downloads the package) may be considered unresponsive. autoApprove allows read-only tools to run without manual confirmation.

Cursor

Add to your MCP settings (Settings > MCP Servers > Add):

{
  "notlai": {
    "command": "npx",
    "args": ["-y", "notlai-mcp"]
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "notlai": {
      "command": "npx",
      "args": ["-y", "notlai-mcp"]
    }
  }
}

Any MCP-compatible client

The server runs as a stdio process. Use the command:

npx -y notlai-mcp

Configure your client to launch this command and communicate via stdin/stdout using the Model Context Protocol.

3. Log in

Once the server is running, ask your assistant:

"Log me in to Notlai via web"

It will start the web login flow and give you a URL. Open it in your browser, enter your credentials, and your session is stored locally.

Alternative: Log in directly in the chat:

"Log me in to Notlai with email user@example.com"

Related MCP server: Notes MCP Server

Available Tools

Tool

Description

notlai_list_notes

List notes with filters (tags, search, dates, folders, pagination)

notlai_get_note

Get the full content of a note

notlai_create_note

Create a note (supports Markdown content)

notlai_update_note

Update a note's title, content, tags, or folder

notlai_delete_note

Permanently delete a note

notlai_bulk_delete_notes

Permanently delete multiple notes at once

notlai_list_folders

List all your folders

notlai_create_folder

Create a new folder

notlai_delete_folder

Delete a folder (notes move back to root)

notlai_move_note

Move a note into a folder or back to root

notlai_list_tags

List all your tags

notlai_create_tag

Create a new tag

notlai_delete_tag

Delete a tag (removes it from all notes)

notlai_web_login

Start web-based login (recommended)

notlai_login

Log in with email/password directly

notlai_register

Create a new account

notlai_status

Check authentication status

notlai_logout

Log out and delete local credentials

Features

  • Markdown content: Notes support full Markdown (headings, lists, code blocks, links, tables, etc.)

  • Folders: Organize notes into folders — move, reclassify, or keep them at root

  • Tags: Organize notes with tags — the AI will automatically suggest relevant tags

  • Bulk operations: Delete multiple notes at once to clean up quickly

  • Search: Full-text search across titles and content

  • Date filters: Filter notes by time period

  • Web view: Browse your notes at www.notlai.com (read-only)

How It Works

  • Credentials are stored locally at ~/.mcp-notes/credentials.json (owner read/write only)

  • Tokens refresh automatically when they expire

  • The web login flow uses a temporary local server on localhost:9876 that shuts down after receiving tokens

  • No data is sent to third parties — authentication goes directly to the Notlai backend (AWS Cognito)

Troubleshooting

Kiro: tools not appearing after setup

If the Notlai tools don't appear in your Kiro session:

  1. Make sure your config includes "timeout": 30000 — without it, the first launch (npx downloading the package) may timeout before the server responds.

  2. Restart your Kiro session after editing mcp.json. MCP servers are loaded at session start.

  3. Check that npx -y notlai-mcp works in your terminal (it should hang waiting for stdin — that's normal).

"Not authenticated" error

Ask your assistant to run notlai_web_login or notlai_login to sign in.

Web login page says "MCP server not reachable"

Make sure your AI client is running and you've asked it to start the web login before opening the link.

Port 9876 is already in use

Ask: "Log me in via web on port 9877" — any available port works.

Requirements

  • Node.js 20+

License

MIT

Available Tools

21 tools
notlai_bulk_delete_notesA

Permanently delete multiple notes at once. This cannot be undone. Use notlai_list_notes to find note IDs.

Inputs: noteIds (required).

notlai_create_folderA

Create a new folder to organize your notes. After creating a folder, use notlai_move_note to move notes into it.

Inputs: name (required).

notlai_create_noteA

Create a new note. Content supports Markdown formatting (headings, lists, code blocks, links, bold, italic, etc.). Before creating, consider using notlai_list_tags to find relevant tags to assign.

Inputs: title (required), content (required), tags, isFavorite.

notlai_create_tagA

Create a new tag for categorizing notes. Check existing tags first with notlai_list_tags to avoid duplicates. Tag names are stored in lowercase.

Inputs: name (required).

notlai_delete_folderA

Delete a folder by its ID. Notes inside the folder are moved back to the root (they are not deleted). Use notlai_list_folders to see folder IDs.

Inputs: folderId (required).

notlai_delete_noteA

Permanently delete a note by its ID. This cannot be undone.

Inputs: noteId (required).

notlai_delete_tagA

Delete a tag by its ID. This also removes the tag from all notes that use it. Use notlai_list_tags to see available tags and their IDs.

Inputs: tagId (required).

notlai_get_noteA

Get the full content of a specific note by its ID.

Inputs: noteId (required).

notlai_get_note_activityA

Get the activity history of a note: who modified what, when, and from which AI. Returns most recent events first.

Inputs: noteId (required), limit.

notlai_list_foldersA

List all your folders. Use folder IDs to filter notes by folder or to move notes into a folder.

Inputs: no named parameters.

notlai_list_notesA

List your notes. Supports filtering by tags, date range, text search, and favorites. Returns the most recently updated notes first.

Inputs: to, from, tags, limit, +5 more.

notlai_list_tagsA

List all your existing tags with their IDs. Use this before creating or updating a note to find relevant tags to assign. When creating a note, pass existing tag names in the tags field.

Inputs: no named parameters.

notlai_loginA

Authenticate with email and password to obtain access tokens

Inputs: email (required), password (required).

notlai_logoutA

Delete local credentials and end the session

Inputs: no named parameters.

notlai_move_noteA

Move a note into a folder, or back to root. Use this to reclassify and organize your notes. Use notlai_list_folders to find folder IDs.

Inputs: noteId (required), folderId (required).

notlai_registerB

Create a new Notlai account with email and password

Inputs: email (required), password (required).

notlai_share_noteA

Share a note. Without email: creates a public link (read-only). With email: shares with a specific user at the given permission level.

Inputs: noteId (required), email, permission.

notlai_statusA

Check authentication status and refresh token if needed

Inputs: no named parameters.

notlai_unshare_noteA

Revoke a share. Without email: revokes the public link. With email: revokes access for that specific user.

Inputs: noteId (required), email.

notlai_update_noteA

Update an existing note. Only provided fields will be changed. Content supports Markdown formatting. Use notlai_list_notes to find the note ID.

Inputs: noteId (required), tags, title, content, +2 more.

notlai_web_loginA

Start web-based login flow. Opens a local auth server and provides a URL to authenticate via the web.

Inputs: port.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4/5.0

    Scored across 21 tools

    Disambiguation5/5

    Each tool targets a distinct action: authentication, note CRUD, folder/tag management, sharing, and activity tracking. No two tools have ambiguous boundaries; descriptions clearly differentiate them.

    Naming Consistency5/5

    All tools follow a consistent 'notlai_verb_noun' pattern in snake_case, making the action and resource clear. Variations like 'bulk_delete_notes' and 'get_note_activity' are predictable extensions.

    Tool Count5/5

    With 21 tools, the server covers authentication, note management, folders, tags, sharing, and bulk operations. The scope is appropriate for a feature-rich note-taking service without excessive tools.

    Completeness4/5

    The tool surface is comprehensive, including full CRUD for notes, folders, tags, plus sharing and activity. Missing a tag update tool is a minor gap, but the core workflows are well-covered.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • notes-box

      MartaVtechzgr
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude Desktop to add, get, and list notes, with state persisted to a JSON file in the home directory.
      MIT

    • mcp-snippetbox

      AAAdiaosbrk
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables managing notes through a simple MCP server, providing tools to add, retrieve, update, delete, and list notes for use with Claude Desktop.
      MIT