home / mcp / noteit mcp server

Noteit MCP Server

Provides an HTTP MCP server that exposes agent profiles and notes with OAuth 2.1 authentication and API token fallback.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "bahfahh-noteit-mcp": {
      "url": "https://www.noteit-mcp.com/api/mcp"
    }
  }
}

Noteit MCP is an HTTP MCP server that securely exposes agent profiles and notes through a unified API, enabling AI coding tools to access composable configurations and visualized notes with OAuth 2.1 authentication and an API token option for non-OAuth clients.

How to use

You interact with the MCP server through your preferred MCP client. The server endpoint is hosted at https://www.noteit-mcp.com/api/mcp and provides endpoints to list, retrieve, and generate agent profiles along with creating and browsing notes. Use OAuth 2.1 with device fingerprint where supported, or fall back to an API token for clients that do not support OAuth. The server is suitable for IDE integrations, enabling you to manage reusable agent configurations and rich, graph-enabled notes across your projects.

How to install

Prerequisites: you should have Node.js or an environment capable of making HTTP requests to the MCP server. Ensure you have an MCP client ready to connect to the Noteit MCP server at the provided URL.

# No local server installation is required for the MCP client to connect to Noteit MCP
# Install and configure your MCP client as you typically would for HTTP MCP endpoints
# Use the official MCP URL for Noteit when configuring the client

Additional sections

Connection methods available from Noteit MCP include an HTTP endpoint and, when any example shows a local runtime, the corresponding stdio configuration would be provided. This guide documents the explicit HTTP endpoint shown for connecting MCP clients.

HTTP connection configuration (explicit): you connect via the following MCP URL. The configuration is defined as an HTTP type MCP server with a direct URL and no local runtime required.

{
  "type": "http",
  "name": "noteit_mcp",
  "url": "https://www.noteit-mcp.com/api/mcp",
  "args": []
}

Tools and endpoints overview

Noteit MCP exposes a suite of tools to manage agent profiles and notes. These tools enable you to list and retrieve profiles, generate profile components, and create and manage diverse notes with visual content.

Available tools

noteit_profiles_list

List user agent profiles containing personas, instructions, rules, and documents for specific roles or tasks.

noteit_profiles_getConfig

Retrieve a composable AI agent configuration profile with personas, instructions, rules, and documents.

noteit_profiles_generate

Generate and save individual configuration components (persona, rule, document, instruction) usable to assemble agent profiles.

noteit_notes_create

Create project notes with four types: note, task, why, and issue for records, tasks, explanations, and problems.

noteit_notes_read

Retrieve the complete content of a specific note by its unique ID.

noteit_notes_list

Browse and filter all notes across projects with optional tag, record type, or project name filters.

noteit_web_create

Generate interactive HTML notes to help explain complex concepts or processes.

noteit_flow_create

Create visual flow diagrams with nested data to illustrate technical processes.