MCP Server for Mem.ai

A production-ready Model Context Protocol (MCP) server that provides AI assistants with intelligent access to Mem.ai's knowledge management platform.

✨ Features

• 🧠 Intelligent Memory: Save and process content with Mem It's AI-powered organization

• 📝 Note Management: Create, read, and delete structured markdown notes

• 📁 Collections: Organize notes into searchable collections

• 🔒 Type-Safe: Full type hints and Pydantic validation

• ⚡ Async/Await: High-performance async I/O throughout

• 🎯 Clean API: Simple, intuitive interface for AI assistants

• 🛡️ Production-Ready: Comprehensive error handling and logging

• 🧪 Well-Tested: Full test suite with pytest

📋 Prerequisites

• Python 3.10 or higher

• A Mem.ai account

• Mem.ai API key (get one here)

🚀 Quick Start

Installation

1. Clone the repository:

2. Install dependencies:

3. Set up your environment:

Running the Server

Local Development

Using with Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

Using with Other MCP Clients

🛠️ Available Tools

1. mem_it - Intelligent Content Processing

Save and automatically process any content type with AI-powered organization.

Parameters:

• input (required): Content to save (text, HTML, markdown, etc.)

• instructions (optional): Processing instructions

• context (optional): Additional context for organization

• timestamp (optional): ISO 8601 timestamp

Example:

2. create_note - Create Structured Note

Create a markdown-formatted note with explicit control over content and organization.

Parameters:

• content (required): Markdown-formatted content

• collection_ids (optional): List of collection UUIDs

• collection_titles (optional): List of collection titles

Example:

3. read_note - Read Note

Retrieve a note's full content and metadata by ID.

Parameters:

• note_id (required): UUID of the note

Example:

4. delete_note - Delete Note

Permanently delete a note by ID.

Parameters:

• note_id (required): UUID of the note

Example:

5. create_collection - Create Collection

Create a new collection to organize related notes.

Parameters:

• title (required): Collection title

• description (optional): Markdown-formatted description

Example:

6. delete_collection - Delete Collection

Delete a collection (notes remain, just unassociated).

Parameters:

• collection_id (required): UUID of the collection

Example:

⚙️ Configuration

Configuration is done via environment variables. Copy .env.example to .env and customize:

🏗️ Architecture

Key Components

• models.py: Pydantic models for request/response validation

• client.py: Async HTTP client wrapper for Mem.ai API

• server.py: FastMCP server with tool implementations

🧪 Testing

Run the test suite:

🔍 Error Handling

The server provides clear, actionable error messages:

• MemAuthenticationError: Invalid or missing API key

• MemNotFoundError: Resource (note/collection) not found

• MemValidationError: Invalid request parameters

• MemAPIError: General API errors

All errors are logged and returned with helpful context to the AI assistant.

📚 Examples

See the examples/ directory for complete usage examples:

• basic_usage.py: Simple examples of each tool

• advanced_usage.py: Complex workflows and patterns

🤝 Contributing

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

1. Fork the repository

2. Create your feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

📄 License

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

🔗 Links

• Mem.ai - Intelligent memory platform

• Mem.ai API Documentation

• Model Context Protocol

• FastMCP - MCP server framework

💡 Use Cases

• Meeting Notes: Automatically process and organize meeting transcripts

• Research: Save and categorize research papers, articles, and findings

• Customer Feedback: Collect and organize customer conversations

• Knowledge Base: Build a searchable knowledge repository

• Personal Memory: Keep track of ideas, thoughts, and learnings

🐛 Troubleshooting

Authentication Error

Solution: Set your MEM_API_KEY in the .env file or environment.

Connection Timeout

Solution: Increase MEM_REQUEST_TIMEOUT in your .env file.

Invalid UUID

Solution: Ensure note/collection IDs are valid UUIDs from Mem.ai.

Built with ❤️ using FastMCP and Mem.ai