Skip to main content
Glama

IMA MCP

A self-hosted MCP bridge for IMA notes and knowledge bases, based on ima-mcp-server under the MIT license.

Source: W-World-Labs/ima-mcp.

The bridge supports searching and browsing knowledge bases, reading and writing notes, importing URLs, uploading Base64 files up to 6 MiB, and direct calls to the IMA note/wiki OpenAPI. Operations use the permissions of your own IMA API credentials. File uploads have been schema-checked; they have not been verified with a real user file.

Run from source

Use Node.js 22 or newer for development and CI. The runtime supports Node.js 18 or newer.

npm ci --ignore-scripts
npm run check

Obtain your own API credentials from the IMA agent interface. Supply IMA_CLIENT_ID, IMA_API_KEY and IMA_MCP_KEY through your process manager or a private environment file. The server does not load .env files itself. Generate a separate MCP access key with:

node -e "console.log(require('node:crypto').randomBytes(32).toString('base64url'))"

Once the variables are set, run npm start. The server binds to 127.0.0.1:18448 and exposes Streamable HTTP at http://127.0.0.1:18448/mcp/<your-access-key>. It does not provide a stdio transport. Configure your MCP client to use that URL. The access key must be at least 40 characters and contain only letters, digits, _ or -.

Variable

Purpose

IMA_CLIENT_ID

Your IMA OpenAPI client ID

IMA_API_KEY

Your IMA OpenAPI API key

IMA_MCP_KEY

Independent access key protecting this MCP endpoint

For compatibility, IMA_OPENAPI_CLIENTID and IMA_OPENAPI_APIKEY are accepted when their primary variables are absent. The final credential fallback reads ~/.config/ima/client_id and ~/.config/ima/api_key.

For remote clients, put the loopback service behind your own authenticated HTTPS ingress. Keep access logs from recording the full MCP path: it contains the access key. The deploy/ units are optional Linux examples; adapt their paths and account locally. The optional tunnel unit requires a separately installed tunnel client and private tunnel configuration. No tunnel binary, credentials or production configuration are included.

Related MCP server: Sensefold MCP server

Build and release

GitHub Actions runs locked dependency installation with lifecycle scripts disabled, syntax checks and package inventory validation on pull requests and pushes. A v<package-version> tag on main additionally publishes the npm archive and its SHA-256 checksum as a GitHub Release. The workflow does not publish to npm or deploy a running server.

npm pack --ignore-scripts

The npm package contains only server.mjs, package.json, this README and LICENSE. Use a source checkout and package-lock.json for locked installation with npm ci.

License

MIT. The upstream project's attribution is preserved in LICENSE.

Third-party code and dependencies

This project is based on xuewolai/ima-mcp-server; its MIT attribution is retained in LICENSE. The direct runtime dependency is @modelcontextprotocol/sdk; package.json and package-lock.json record the declared and locked dependency graph. Dependencies retain their own licenses. IMA is a separately operated service and is not included in this package. Review the upstream and dependency license texts when redistributing.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables Agents to retrieve structured evidence with spans, versions, and content hashes from a self-hosted knowledge base, and optionally delegate single-shot questions. Exposes read-only search, evidence lookup, and answer tools over Streamable HTTP with Bearer authentication.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI clients like Claude, ChatGPT, and Cursor to search, read, and write back to one cross-model Markdown library of saved articles, videos, PDFs, notes, and conversations. Hosted remote server with OAuth 2.1 or Agent-key auth and read_only, edit, or full permission tiers.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Exposes a remote Streamable HTTP MCP endpoint that lets an AI client save, search, and retrieve structured memories, archived conversations, social-account notes, and knowledge documents. Access is scoped by per-client API keys with configurable read/write permission levels, collections, and operations.
      ISC
    • F
      license
      Not graded
      quality
      A
      maintenance
      Gives AI agents access to a persistent document workspace so they can search, read, and update knowledge through 22 focused tools, 2 prompts, and 3 resources, with batch actions and direct workspace-item inspection. Runs either as a hosted Streamable HTTP endpoint with OAuth or API keys, or as a self-hosted stdio bridge pointed at your own instance.
      -