mem.ai MCP Server

Model Context Protocol (MCP) server for mem.ai API integration. This server enables AI assistants like Claude to interact with your mem.ai memory through a standardized interface.

Features

• Complete API Coverage: All 11 mem.ai API endpoints wrapped as MCP tools

• TypeScript: Fully typed with strict mode enabled

• Easy Integration: Works seamlessly with Claude Desktop and other MCP clients

• Error Handling: Comprehensive error handling with detailed messages

• Validation: Input validation using Zod schemas

Related MCP server: MCP Server for Mem.ai

Installation

No installation required! You can run the server directly using npx (recommended), or install it globally if you prefer.

Using npx (Recommended)

npx @hskksk/mem-ai-mcp-server

This automatically downloads and runs the latest version without requiring installation.

Global Installation (Optional)

npm install -g @hskksk/mem-ai-mcp-server

Configuration

Get Your API Key

1. Visit mem.ai settings

2. Generate a new API key

3. Copy the key for configuration

Environment Variables

Create a .env file or set environment variables:

MEM_API_KEY=your_api_key_here

Optional configuration:

# Override the default API base URL (default: https://api.mem.ai)
MEM_API_BASE_URL=https://api.mem.ai

Usage

With Claude Desktop (Recommended)

Add the following configuration to your Claude Desktop config file:

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

{
  "mcpServers": {
    "mem-ai": {
      "command": "npx",
      "args": ["-y", "@hskksk/mem-ai-mcp-server"],
      "env": {
        "MEM_API_KEY": "your_api_key_here"
      }
    }
  }
}

After restarting Claude Desktop, you'll be able to use mem.ai tools in your conversations.

Alternative: Using Global Installation

If you've installed the package globally:

{
  "mcpServers": {
    "mem-ai": {
      "command": "mem-ai-mcp-server",
      "env": {
        "MEM_API_KEY": "your_api_key_here"
      }
    }
  }
}

Standalone Usage

# Using npx (recommended)
MEM_API_KEY=your_api_key_here npx @hskksk/mem-ai-mcp-server

# Or if installed globally
MEM_API_KEY=your_api_key_here mem-ai-mcp-server

Available Tools

Mem It

• mem_it - Remember any content intelligently

  • Primary endpoint for saving information to mem.ai

  • Supports context and instructions for better processing

  • Parameters: input (required), instructions, context, timestamp

Notes Management

• create_note - Create a new note with markdown content

  • Parameters: content (required), id, collection_ids, collection_titles, created_at, updated_at

• get_note - Retrieve a specific note by ID

  • Parameters: noteId (required)

• delete_note - Delete a note

  • Parameters: noteId (required)

• list_notes - List all notes with advanced filtering and pagination

  • Supports cursor-based pagination with page and next_page

  • Parameters:

    • limit - Maximum number of results (default: 50, max: 100)

    • page - Cursor for pagination (from previous next_page)

    • order_by - Sort order: created_at or updated_at (default: updated_at)

    • collection_id - Filter by collection ID

    • contains_open_tasks - Filter notes with open tasks

    • contains_tasks - Filter notes with any tasks

    • contains_images - Filter notes with images

    • contains_files - Filter notes with files/attachments

    • include_note_content - Include full markdown content in response

• search_notes - Search across notes with advanced filtering

  • Parameters:

    • query - Search query (optional)

    • filter_by_collection_ids - Filter by collection IDs array

    • filter_by_contains_open_tasks - Filter notes with open tasks

    • filter_by_contains_tasks - Filter notes with any tasks

    • filter_by_contains_images - Filter notes with images

    • filter_by_contains_files - Filter notes with files

    • config - Response configuration (include_snippet, include_content)

Collections Management

• create_collection - Create a new collection

  • Parameters: title (required), description

• get_collection - Retrieve a specific collection by ID

  • Parameters: collectionId (required)

• delete_collection - Delete a collection

  • Parameters: collectionId (required)

• list_collections - List all collections with pagination

  • Supports cursor-based pagination with page and next_page

  • Parameters:

    • limit - Maximum number of results (default: 50, max: 100)

    • page - Cursor for pagination (from previous next_page)

    • order_by - Sort order: created_at or updated_at (default: updated_at)

• search_collections - Search across collections

  • Parameters:

    • query - Search query (optional)

    • config - Response configuration (include_description)

Development

Prerequisites

• Node.js >= 20.0.0

• pnpm (recommended) or npm

Setup

# Clone the repository
git clone https://github.com/hskksk/mem-ai-mcp-server.git
cd mem-ai-mcp-server

# Install dependencies
pnpm install

# Copy environment template
cp .env.example .env

# Edit .env and add your API key

Development Commands

# Run in development mode with auto-reload
pnpm dev

# Build the project
pnpm build

# Run tests
pnpm test

# Type check
pnpm type-check

# Lint
pnpm lint

Project Structure

src/
├── index.ts              # Entry point
├── server.ts             # MCP server setup
├── config/
│   └── env.ts           # Environment configuration
├── client/
│   └── mem-api-client.ts # mem.ai API client
├── tools/               # MCP tool implementations
│   ├── base-tool.ts
│   ├── mem-it.ts
│   ├── notes/
│   └── collections/
├── types/               # TypeScript type definitions
└── utils/               # Utility functions

API Documentation

For detailed information about the mem.ai API, visit the official API documentation.

Error Handling

The server provides detailed error messages for common issues:

• 401 Unauthorized: Invalid API key

• 404 Not Found: Resource not found

• 429 Too Many Requests: Rate limit exceeded

• 500 Server Error: Internal server error

All errors are returned in a structured format for easy debugging.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Links

• GitHub Repository

• npm Package

• mem.ai Website

• MCP Documentation

Support

If you encounter any issues or have questions:

1. Check the GitHub Issues

2. Create a new issue with detailed information

3. Refer to the mem.ai API documentation

Changelog

See CHANGELOG.md for the full version history.