Documentation

Learn how to capture, organize, and access your notes with Neemee

Getting Started

Neemee is your personal notes system. Capture web content, organize with notebooks, and access your notes and notebooks through AI tools or the web interface.

1. Capture

Use the bookmarklet to capture web articles, docs, or any content

2. Organize

Create notebooks and tag notes with custom metadata

3. Access

Query your notes and notebooks with AI tools

Bookmarklet Installation

The Neemee bookmarklet lets you capture web content with a single click. It extracts the main content, metadata, and lets you organize it instantly.

1

Navigate to Settings

From your Neemee dashboard, click the dropdown menu to the right of the app name in the navbar and select Settings.

Dashboard → Navigation Dropdown → Settings
2

Install the Bookmarklet

In the "Bookmarklet" section of settings, you have two installation methods:

Method 1: Drag & Drop (Easiest)
  1. Locate the "Post to Neemee" button in the settings page
  2. Drag the button directly to your browser's bookmarks bar
  3. Release to install - that's it!
Method 2: Copy & Paste
  1. Click the "Copy Code" button to copy the JavaScript bookmarklet code
  2. Create a new bookmark in your browser
  3. Set the name to "Post to Neemee" (or any name you prefer)
  4. Paste the copied code as the bookmark URL
  5. Save the bookmark
3

Capture Content

Select the content you want to capture on any webpage, then click the bookmarklet. A capture window will appear where you can:

  • Review the captured highlight
  • Edit the page title
  • Assign to a notebook
  • Add tags

Notebook Organization

Notebooks are containers for organizing related notes by topic, project, or any category that makes sense for your workflow.

Creating Notebooks

  • Click "New Notebook" in the notebooks page
  • Give it a descriptive name and optional description
  • Notebooks can be created before or after adding notes

Assigning Notes

  • Assign during capture with the bookmarklet
  • Edit existing notes to change notebook assignment
  • Notes can belong to only one notebook at a time

Best Practices

1

Use Clear, Specific Names

Instead of "Work", try "Q1 2024 Project Planning" or "Client Meeting Notes"

2

Start Broad, Then Refine

Begin with general categories and create more specific notebooks as your collection grows

3

Combine with Tags

Use notebooks for broad categories and frontmatter tags for cross-cutting themes

4

Archive When Done

Consider creating an "Archive" notebook for completed project notes

Understanding Model Context Protocol (MCP)

What is MCP?

The Model Context Protocol (MCP) is an open standard that enables AI assistants like Claude, ChatGPT, and Gemini to securely connect to external data sources and tools. Think of it as a universal adapter that lets AI interact with your applications through a standardized interface.

With MCP, AI assistants can read, search, and manage your Neemee notes directly from conversations, making your notes an extension of their capabilities.

Secure

OAuth 2.0 authentication ensures your data stays private and secure

Standardized

Built on open standards for reliable, consistent integration

Powerful

Full access to your notes from any AI conversation

How Neemee Connects to AI Tools

The Neemee MCP server acts as a bridge between AI tools and your notes, translating requests into actions on your notes and notebooks.

1

AI Sends Request

When you ask an AI to search your notes or create content, it generates an MCP request

2

MCP Server Processes

The Neemee MCP server receives the request, authenticates it, and translates it into API calls

3

Neemee Responds

Your Neemee account processes the request and returns the relevant data

4

AI Uses Results

The AI receives the data and incorporates it into the conversation naturally

Authentication Methods

Neemee supports two authentication methods for MCP connections. Choose the method that best fits your use case:

Recommended

OAuth 2.0

Secure browser-based authentication using industry-standard OAuth 2.0 protocol.

Most secure authentication method
No API keys to manage or rotate
Easy to revoke access anytime
Works with Claude Desktop and ChatGPT automatically

Best for: Claude Desktop, ChatGPT, personal use, secure access

Advanced

API Key

Direct API authentication using a generated key for programmatic access.

Simple setup for local development
Useful for testing and automation
May be required depending on your AI tool
Requires manual key management

Best for: CLI tools, local development, CI/CD pipelines, custom integrations

Connect Claude Desktop

Connect Neemee to Claude Desktop to query your notes and notebooks directly from conversations using the Model Context Protocol (MCP).

1

Open Claude Desktop Settings

Launch Claude Desktop and navigate to settings:

  1. Click the settings icon (gear) in the top-right corner
  2. Select Connectors from the left sidebar
2

Add Custom Connector

At the bottom of the Connectors section:

  1. Click "Add custom connector"
  2. Enter the connector details:
    • Name: Neemee
    • Server URL: https://neemee.app/mcp
    • Description (optional): Access my personal notes and notebooks
  3. Click "Add" to save the connector
3

Authenticate via OAuth

When you first use the Neemee connector:

  1. Claude will prompt you to authorize the connection
  2. Click the authorization link to open your browser
  3. Sign in to your Neemee account (using Google or GitHub)
  4. Grant Claude access to your notes
  5. Return to Claude Desktop to start using the connector
4

Start Using Neemee

Once connected, you can query your notes naturally in any conversation:

  • Search: "Find all my notes about machine learning"
  • Read: "Show me the content of my React 19 note"
  • Create: "Save this code snippet to my notes"
  • Organize: "What notebooks do I have?"

Connect Claude Code

Connect Neemee to Claude Code (the CLI tool) to access your notes and notebooks directly from your terminal and coding workflows using the Model Context Protocol (MCP).

1

Generate API Key

First, create an API key for Claude Code access:

  1. Navigate to your Neemee Settings page
  2. Click the dropdown menu to the right of the app name → Settings
  3. Scroll to the "API Keys" section
  4. Click "Generate New API Key"
  5. Copy the generated key (you won't be able to see it again)
2

Install MCP Server Package

Install the Neemee MCP server package globally using npm:

npm install -g neemee-mcp

This installs the neemee-mcp package which provides the MCP server for Claude Code integration.

3

Configure Claude Code

Add the Neemee MCP server to your Claude Code configuration file:

Location: ~/.claude.json

Add this configuration to your mcpServers section:

{
  "neemee-production": {
    "command": "npx",
    "args": [
      "neemee-mcp"
    ],
    "env": {
      "NEEMEE_API_KEY": "your-api-key-here",
      "NEEMEE_API_BASE_URL": "https://neemee.app/mcp"
    },
    "description": "Neemee notes and notebooks"
  }
}

Replace your-api-key-here with the API key you generated in Step 1.

4

Verify Connection

Test that Claude Code can connect to your Neemee notes:

  1. Open a new terminal session
  2. Start Claude Code (if not already running)
  3. Try a test query: "List my notebooks"
  4. Claude Code should now have access to your Neemee notes and notebooks
5

Start Using Neemee

Once connected, you can interact with your notes from Claude Code:

  • Search: "Find all my notes about React"
  • Read: "Show me my TypeScript best practices note"
  • Create: "Save this code snippet to my notes"
  • Organize: "What notebooks do I have?"
  • Coding Workflow: "Review my API design notes while I refactor this code"

Connect ChatGPT (Developer Mode)

Connect Neemee to ChatGPT using Developer Mode to access your notes and notebooks with the Model Context Protocol (MCP). Configure once via the web interface, and Neemee becomes available in both the web and desktop versions of ChatGPT.

1

Enable Developer Mode

First, enable Developer Mode in ChatGPT:

  1. Open ChatGPT settings (click your profile icon)
  2. Navigate to Connectors
  3. Go to Advanced settings
  4. Toggle on Developer Mode
2

Create Custom Connector

In the Connectors settings, create a new connector:

  1. Click "Create" or "+ Add Custom Connector"
  2. Fill in the connector details:
    • Name: Neemee
    • MCP Server URL: https://neemee.app/mcp
    • Description (optional): Access personal notes and notebooks
    • Icon (optional): Upload or skip
  3. Click "Save" or "Create"
3

Authenticate via OAuth

When you first activate the Neemee connector in a chat:

  1. ChatGPT will prompt you for authorization
  2. Click the authorization link to open your browser
  3. Sign in to your Neemee account (using Google or GitHub)
  4. Grant ChatGPT access to your notes
  5. Return to ChatGPT to continue

Example queries:

  • Search: "Find notes about TypeScript best practices"
  • Read: "What's in my Next.js deployment guide?"
  • Create: "Add this debugging tip to my notes"
  • Organize: "List all my notebooks"

Connect Codex CLI

Connect Neemee to Codex CLI to access your notes and notebooks directly from the terminal with the Model Context Protocol (MCP). Codex CLI uses a TOML configuration format.

1

Generate API Key

First, create an API key for Codex CLI access:

  1. Navigate to your Neemee Settings page
  2. Click the dropdown menu to the right of the app name → Settings
  3. Scroll to the "API Keys" section
  4. Click "Generate New API Key"
  5. Copy the generated key (you won't be able to see it again)
2

Install MCP Server Package

Install the Neemee MCP server package globally using npm:

npm install -g neemee-mcp

This installs the neemee-mcp package which provides the MCP server for Codex CLI integration.

3

Configure Codex CLI

Add the Neemee MCP server to your Codex CLI configuration file:

Location: ~/.codex/config.toml

Add this configuration to your config file:

[mcp_servers.neemeeProduction]
command = "npx"
args = ["neemee-mcp"]
env = { NEEMEE_API_KEY = "your-api-key-here", NEEMEE_API_BASE_URL = "https://neemee.app/mcp" }
description = "Neemee notes and notebooks"

Replace your-api-key-here with the API key you generated in Step 1.

4

Verify Connection

Test that Codex CLI can connect to your Neemee notes:

  1. Open a new terminal session
  2. Start Codex CLI (if not already running)
  3. Use the /mcp command to check MCP server status
  4. Try a test query: "List my notebooks"
  5. Codex CLI should now have access to your Neemee notes and notebooks
5

Start Using Neemee

Once connected, you can interact with your notes from Codex CLI:

  • Search: "Find all my notes about React"
  • Read: "Show me my TypeScript best practices note"
  • Create: "Save this code snippet to my notes"
  • Organize: "What notebooks do I have?"
  • Coding Workflow: "Review my API design notes while I refactor this code"

Troubleshooting

Connection Timeout

If you get a timeout error, ensure:

  • Your API key is valid and hasn't expired
  • The neemee-mcp package is installed globally
  • The TOML syntax is correct (no extra quotes or brackets)

403 Forbidden Error

This usually means the API key is incorrect. Double-check:

  • You copied the entire API key without extra spaces
  • The API key hasn't been revoked in settings
  • You're using the latest version: npm install -g neemee-mcp@latest

Connect Gemini CLI

Connect Neemee to Gemini CLI to access your notes and notebooks directly from the terminal with the Model Context Protocol (MCP). Gemini CLI uses a JSON configuration format.

1

Generate API Key

First, create an API key for Gemini CLI access:

  1. Navigate to your Neemee Settings page
  2. Click the dropdown menu to the right of the app name → Settings
  3. Scroll to the "API Keys" section
  4. Click "Generate New API Key"
  5. Copy the generated key (you won't be able to see it again)
2

Install Gemini CLI

Install the Gemini CLI globally using npm:

npm install -g @google/gemini-cli

This installs Google's Gemini CLI tool which supports MCP server integration.

3

Install MCP Server Package

Install the Neemee MCP server package globally using npm:

npm install -g neemee-mcp

This installs the neemee-mcp package which provides the MCP server for Gemini CLI integration.

4

Configure Gemini CLI

Add the Neemee MCP server to your Gemini CLI configuration file:

Configuration file locations:

  • Project-specific: ~/Developer/.gemini/settings.json
  • Global: ~/.gemini/settings.json

Add this configuration to your settings.json file's mcpServers section:

{
  "mcpServers": {
    "neemee": {
      "command": "npx",
      "args": [
        "-y",
        "neemee-mcp"
      ],
      "env": {
        "NEEMEE_API_KEY": "your-api-key-here",
        "NEEMEE_API_BASE_URL": "https://neemee.app/mcp"
      }
    }
  }
}

Replace your-api-key-here with the API key you generated in Step 1.

5

Verify Connection

Test that Gemini CLI can connect to your Neemee notes:

  1. Open a new terminal session
  2. Launch Gemini CLI with: gemini
  3. Use @neemee to reference your notes in queries
  4. Try a test query: "List my notebooks"
  5. Gemini CLI should now have access to your Neemee notes and notebooks
6

Start Using Neemee

Once connected, you can interact with your notes from Gemini CLI:

  • Search: "Find all my notes about React"
  • Read: "Show me my TypeScript best practices note"
  • Create: "Save this code snippet to my notes"
  • Organize: "What notebooks do I have?"
  • Coding Workflow: "Review my API design notes while I refactor this code"

Troubleshooting

Connection Closed Error

If you get a "connection closed" error, ensure:

  • Your API key is valid and correctly copied
  • The neemee-mcp package is installed globally
  • The JSON syntax is correct (no trailing commas, proper quotes)
  • Environment variables are properly set in the config

401 Unauthorized Error

This usually means the API key is incorrect or expired. Double-check:

  • You copied the entire API key without extra spaces
  • The API key hasn't been revoked in settings
  • You're using the latest version: npm install -g neemee-mcp@latest

Frontmatter Field Reference

YAML frontmatter lets you add structured metadata to your notes. Define custom fields to track status, priority, tags, dates, and more. All fields are searchable through the MCP server.

String

Text Fields

Simple text values for labels, names, or descriptions

author: "John Doe"
project: "Neemee Development"
source: "Medium Article"
Array

Tag Lists

Multiple values for categorization and filtering

tags: ["react", "typescript", "tutorial"]
categories: ["frontend", "web-development"]
technologies: ["Next.js", "Tailwind CSS"]
Choice

Select Options

Predefined options for consistent values

status: "in-progress"  # Options: todo, in-progress, done
priority: "high"         # Options: low, medium, high
type: "tutorial"         # Options: article, tutorial, reference
Date

Date Fields

Track deadlines, publication dates, or milestones

due_date: "2024-03-15"
published: "2024-01-10"
reviewed: "2024-02-20"
Boolean

True/False Flags

Binary states for completion, importance, or features

completed: true
favorite: false
archived: false
Number

Numeric Values

Ratings, counts, or measurements

rating: 5
reading_time: 12
page_count: 247

Example: Complete Note Frontmatter

---
title: "Building Production-Ready Next.js Apps"
author: "Sarah Chen"
tags: ["nextjs", "react", "production", "deployment"]
categories: ["web-development", "frontend"]
status: "done"
priority: "high"
rating: 5
reading_time: 15
published: "2024-01-15"
due_date: "2024-02-01"
completed: true
favorite: true
source: "Dev.to"
type: "tutorial"
difficulty: "advanced"
---

# Note content starts here...

Ready to Get Started?

Set up your bookmarklet, organize with notebooks, and connect to AI tools to unlock the full power of Neemee.