Memolink MCP Server

A Model Context Protocol (MCP) server that connects your AI assistants (Claude, Cursor, Windsurf, etc.) with your Memolink workspace. This integration allows AI agents to read, search, and manage your research notes, memos, and goals directly.

✨ Features

• 📝 Memo Management: Create, read, search, and update research notes.
• 📉 Daily Summaries: Get AI-generated summaries of your recent memos.
• 🏷️ Tags & Goals: Organize search and track your research progress.
• 🛠️ Developer Friendly: Built with TypeScript and the Model Context Protocol SDK.

Quick Setup

Connect Memolink to your favorite AI assistant in seconds using the built-in setup CLI:

npx memolink-mcp setup <provider> <MEMOLINK_API_KEY>

Supported Providers:

• claude - Claude Desktop App
• cursor - Cursor Code Editor
• windsurf - Windsurf Editor
• gemini - Google Gemini / AI Studio
• roo-cline - VS Code Roo-Cline extension
• antigravity - Antigravity AI Assistant

[!IMPORTANT] Your Memolink API Key must start with mclk_. You can find this in your Memolink settings.

🌥️ Cloudflare Workers Deployment

You can deploy Memolink MCP as a serverless Cloudflare Worker to provide a persistent, multi-tenant SSE (Server-Sent Events) endpoint for your AI assistants.

Quick Deploy:

1. Clone the repository and install dependencies:

   git clone https://github.com/Opstin-Technologies/memolink-mcp.git
   cd memolink-mcp
   npm install

2. Build and deploy to your Cloudflare account:

   npm run deploy

Setup on Cloudflare:

Once deployed, configure the environment variable:

• MEMOLINK_API_URL: https://your-memolink-api.com/api (Optional).

Connecting to SSE:

The worker provides an MCP-compliant SSE endpoint at: https://memolink-mcp.<your-subdomain>.workers.dev/mcp/sse

Authentication: The SSE endpoint requires your Memolink API Key. You can provide it in two ways:

1. Authorization Header: Bearer mclk_SECRET
2. Query Parameter: ?apiKey=mclk_SECRET

Example for claude_desktop_config.json (SSE Mode):

{
  "mcpServers": {
    "memolink-cloud": {
      "url": "https://memolink-mcp.your-subdomain.workers.dev/mcp/sse?apiKey=mclk_your_secret_key"
    }
  }
}

🛠️ Available Tools

The following tools are exposed to your AI assistant:

| Tool | Description | |------|-------------| | create_memo | Create a new research note or personal memo. | | search_memos | Search for existing memos using keywords or semantic search. | | list_memos | List memos with pagination and filters (by objective, user, etc.). | | get_daily_summary | Retrieve a summary of memos created on a specific day. | | read_memo | Get the full content and metadata of a specific memo. | | update_memo | Modify the content, tags, or status of an existing memo. | | delete_memo | Permanently delete a memo by ID. | | get_tags | List all available organization tags. | | get_goals | View your active research goals and progress. | | create_goal | Define a new objective for your research. |

Manual Configuration

If you prefer to configure your environment manually, ensure the following environment variables are set:

• MEMOLINK_API_KEY: Your private Memolink API Key.
• MEMOLINK_API_URL: (Optional) Defaults to https://memolink.opstintechnologies.com/api.

Example for claude_desktop_config.json:

{
  "mcpServers": {
    "memolink": {
      "command": "npx",
      "args": ["-y", "memolink-mcp"],
      "env": {
        "MEMOLINK_API_KEY": "mclk_your_secret_key",
        "MEMOLINK_API_URL": "https://memolink.opstintechnologies.com/api"
      }
    }
  }
}

Development

Build

npm install
npm run build

Run Dev Server

npm run dev

Built by Opstin Technologies Team