obris-mcp 0.2.1

MCP server for Obris — bring your saved knowledge into AI conversations

Obris MCP Server

An MCP server that brings your saved Obris knowledge into AI conversations on Claude, ChatGPT, Gemini, and any MCP-compatible client.

Features

• List topics — Browse all your Obris topics to find the one you need
• Pull in knowledge — Retrieve saved bookmarks, highlights, and notes as context for any conversation
• Read-only — The server only reads your data; it never modifies anything in your Obris account

Setup

1. Get your API key

Generate an API key from your Obris dashboard. Don't have an account? Sign up.

2. Install and configure

Claude Desktop (Recommended)

Build and install the extension bundle:

npm install -g @anthropic-ai/mcpb
git clone https://github.com/obris-dev/obris-mcp.git
cd obris-mcp
mcpb pack .

Then in Claude Desktop, go to Settings > Extensions > Install Extension and select the generated obris-mcp.mcpb file. You'll be prompted to enter your API key during setup.

Claude Desktop (Manual config)

Alternatively, add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "obris": {
      "command": "uvx",
      "args": ["obris-mcp"],
      "env": {
        "OBRIS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Other MCP clients

# Install
pip install obris-mcp

# Set your API key
export OBRIS_API_KEY=your_api_key_here

# Run
obris-mcp

Tools

Tool	Description
list_topics	List all your Obris topics
get_topic_knowledge	Get saved knowledge for a specific topic

Examples

Example 1: Listing your topics

Prompt: "What Obris topics do I have?"

The list_topics tool is called and returns:

Topics:
- Marketing Strategy (id: 01JEXAMPLE00001)
- Product Roadmap (id: 01JEXAMPLE00002)
- Competitive Analysis (id: 01JEXAMPLE00003)

Example 2: Getting knowledge for a topic

Prompt: "Pull in my saved knowledge for the Marketing Strategy topic."

The list_topics tool is called first to find the topic ID, then get_topic_knowledge is called with topic_id: "01JEXAMPLE00001":

### How to Build a Content Strategy
Content strategy starts with understanding your audience...
(source: https://example.com/content-strategy)
---
### SEO Best Practices 2025
Focus on search intent rather than keyword density...
(source: https://example.com/seo-guide)

Example 3: Using knowledge as context for a task

Prompt: "Using my Competitive Analysis knowledge, summarize the key differentiators of our top 3 competitors."

The list_topics tool finds the Competitive Analysis topic, then get_topic_knowledge retrieves all saved knowledge. The AI uses that knowledge as context to generate a structured summary of competitor differentiators based on your saved research.

Development

# Clone and install
git clone https://github.com/obris-dev/obris-mcp.git
cd obris-mcp
cp .env.example .env  # Add your API key

# Install with uv
uv sync

# Run locally
uv run obris-mcp

Privacy Policy

This server sends your Obris API key to the Obris API (api.obris.ai) to authenticate requests. It retrieves topic and knowledge data from your account. No data is stored locally or sent to any third party.

For the full privacy policy, see obris.ai/privacy.

Support

For issues or questions, contact [e-mail] or open an issue on GitHub.

License

MIT