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.
Navigate to Settings
From your Neemee dashboard, click the dropdown menu to the right of the app name in the navbar and select Settings.
Install the Bookmarklet
In the "Bookmarklet" section of settings, you have two installation methods:
Method 1: Drag & Drop (Easiest)
- Locate the "Post to Neemee" button in the settings page
- Drag the button directly to your browser's bookmarks bar
- Release to install - that's it!
Method 2: Copy & Paste
- Click the "Copy Code" button to copy the JavaScript bookmarklet code
- Create a new bookmark in your browser
- Set the name to "Post to Neemee" (or any name you prefer)
- Paste the copied code as the bookmark URL
- Save the bookmark
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
Use Clear, Specific Names
Instead of "Work", try "Q1 2024 Project Planning" or "Client Meeting Notes"
Start Broad, Then Refine
Begin with general categories and create more specific notebooks as your collection grows
Combine with Tags
Use notebooks for broad categories and frontmatter tags for cross-cutting themes
Archive When Done
Consider creating an "Archive" notebook for completed project notes
Understanding Model Context Protocol (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
The Neemee MCP server acts as a bridge between AI tools and your notes, translating requests into actions on your notes and notebooks.
AI Sends Request
When you ask an AI to search your notes or create content, it generates an MCP request
MCP Server Processes
The Neemee MCP server receives the request, authenticates it, and translates it into API calls
Neemee Responds
Your Neemee account processes the request and returns the relevant data
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:
OAuth 2.0
Secure browser-based authentication using industry-standard OAuth 2.0 protocol.
Best for: Claude Desktop, ChatGPT, personal use, secure access
API Key
Direct API authentication using a generated key for programmatic access.
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).
Open Claude Desktop Settings
Launch Claude Desktop and navigate to settings:
- Click the settings icon (gear) in the top-right corner
- Select Connectors from the left sidebar
Add Custom Connector
At the bottom of the Connectors section:
- Click "Add custom connector"
- Enter the connector details:
- Name: Neemee
- Server URL:
https://neemee.app/mcp - Description (optional): Access my personal notes and notebooks
- Click "Add" to save the connector
Authenticate via OAuth
When you first use the Neemee connector:
- Claude will prompt you to authorize the connection
- Click the authorization link to open your browser
- Sign in to your Neemee account (using Google or GitHub)
- Grant Claude access to your notes
- Return to Claude Desktop to start using the connector
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).
Generate API Key
First, create an API key for Claude Code access:
- Navigate to your Neemee Settings page
- Click the dropdown menu to the right of the app name → Settings
- Scroll to the "API Keys" section
- Click "Generate New API Key"
- Copy the generated key (you won't be able to see it again)
Install MCP Server Package
Install the Neemee MCP server package globally using npm:
npm install -g neemee-mcpThis installs the neemee-mcp package which provides the MCP server for Claude Code integration.
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.
{"type": "http", "url": "https://neemee.app/mcp"}Verify Connection
Test that Claude Code can connect to your Neemee notes:
- Open a new terminal session
- Start Claude Code (if not already running)
- Try a test query: "List my notebooks"
- Claude Code should now have access to your Neemee notes and notebooks
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.
Enable Developer Mode
First, enable Developer Mode in ChatGPT:
- Open ChatGPT settings (click your profile icon)
- Navigate to Connectors
- Go to Advanced settings
- Toggle on Developer Mode
Create Custom Connector
In the Connectors settings, create a new connector:
- Click "Create" or "+ Add Custom Connector"
- 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
- Click "Save" or "Create"
Authenticate via OAuth
When you first activate the Neemee connector in a chat:
- ChatGPT will prompt you for authorization
- Click the authorization link to open your browser
- Sign in to your Neemee account (using Google or GitHub)
- Grant ChatGPT access to your notes
- 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.
Generate API Key
First, create an API key for Codex CLI access:
- Navigate to your Neemee Settings page
- Click the dropdown menu to the right of the app name → Settings
- Scroll to the "API Keys" section
- Click "Generate New API Key"
- Copy the generated key (you won't be able to see it again)
Install MCP Server Package
Install the Neemee MCP server package globally using npm:
npm install -g neemee-mcpThis installs the neemee-mcp package which provides the MCP server for Codex CLI integration.
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.
Verify Connection
Test that Codex CLI can connect to your Neemee notes:
- Open a new terminal session
- Start Codex CLI (if not already running)
- Use the
/mcpcommand to check MCP server status - Try a test query: "List my notebooks"
- Codex CLI should now have access to your Neemee notes and notebooks
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-mcppackage 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.
Generate API Key
First, create an API key for Gemini CLI access:
- Navigate to your Neemee Settings page
- Click the dropdown menu to the right of the app name → Settings
- Scroll to the "API Keys" section
- Click "Generate New API Key"
- Copy the generated key (you won't be able to see it again)
Install Gemini CLI
Install the Gemini CLI globally using npm:
npm install -g @google/gemini-cliThis installs Google's Gemini CLI tool which supports MCP server integration.
Install MCP Server Package
Install the Neemee MCP server package globally using npm:
npm install -g neemee-mcpThis installs the neemee-mcp package which provides the MCP server for Gemini CLI integration.
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.
mcpServers object.Verify Connection
Test that Gemini CLI can connect to your Neemee notes:
- Open a new terminal session
- Launch Gemini CLI with:
gemini - Use
@neemeeto reference your notes in queries - Try a test query: "List my notebooks"
- Gemini CLI should now have access to your Neemee notes and notebooks
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-mcppackage 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.
Text Fields
Simple text values for labels, names, or descriptions
author: "John Doe"
project: "Neemee Development"
source: "Medium Article"Tag Lists
Multiple values for categorization and filtering
tags: ["react", "typescript", "tutorial"]
categories: ["frontend", "web-development"]
technologies: ["Next.js", "Tailwind CSS"]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, referenceDate Fields
Track deadlines, publication dates, or milestones
due_date: "2024-03-15"
published: "2024-01-10"
reviewed: "2024-02-20"True/False Flags
Binary states for completion, importance, or features
completed: true
favorite: false
archived: falseNumeric Values
Ratings, counts, or measurements
rating: 5
reading_time: 12
page_count: 247Example: 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.