home / mcp / ai note mcp server

AI Note MCP Server

Provides secure access to AI Note tasks via MCP for Claude Desktop and compatible clients.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "ainote-dev-ainote-mcp": {
      "url": "https://api.ainote.dev/mcp",
      "headers": {
        "AINOTE_API_KEY": "REPLACE_WITH_YOUR_API_KEY",
        "AINOTE_API_URL": "https://your-ai-note-domain.com",
        "AINOTE_MCP_HTTP_PORT": "3030",
        "AINOTE_ENABLE_OAUTH_AUTH": "false",
        "AINOTE_MCP_ALLOWED_HOSTS": "host1.local,host2.local",
        "AINOTE_MCP_ALLOWED_ORIGINS": "https://example.com,https://another.example"
      }
    }
  }
}

You can connect Claude Desktop and other MCP-compatible clients to your AI Note tasks using the AI Note MCP Server. It lets you manage tasks directly from conversations, with secure access and a consistent tool catalog across multiple transport methods.

How to use

Start by choosing the transport that fits your setup: a local stdio connection for personal use, a local SSE/HTTP bridge for broader clients, or a hosted HTTP endpoint for platform integrations. Once configured, you can ask Claude Desktop or other MCP clients to list, create, update, or delete tasks, search by content or status, and manage categories and due dates. Use natural language to interact with your AI Note tasks, and rely on secure API key authentication to protect access.

How to install

Prerequisites you need before installation are Node.js version 18.0.0 or newer and a package manager such as npm or yarn. You also need an API key from your AI Note account and Claude Desktop with MCP support enabled.

# Option 1: Install from npm (global stdio mode)
npm install -g @ainote/mcp

# Option 2: Install from source
git clone https://github.com/ainote-dev/ainote-mcp.git
cd ainote-mcp-server
npm install

Configuration and setup tips

To connect the MCP server with Claude Desktop, you will configure a server entry in Claude’s MCP section. You need your AI Note API key and you may optionally point to a dedicated AI Note API URL if you are using a self-hosted or different instance.

Security and access

All interactions require an API key. For local development bridge usage, you can enable optional OAuth bearer token support if you prefer to forward OAuth tokens to the AI Note API.

Troubleshooting tips

If you encounter issues, verify that the API key is set correctly in your environment or Claude configuration, confirm the API URL is reachable, and ensure the MCP server is actively running. Restart Claude Desktop after configuration changes to load updates.

Available tools

list_tasks

List tasks from AI Note with optional filters for status, limit, and search keywords.

create_task

Create a new task with content, optional importance, due date, and category.

update_task

Update an existing task, including content, importance, completion status, and due date.

delete_task

Soft delete a task by its ID.

list_categories

List all available task categories.